Authentication API
  • 22 May 2024
  • 1 Minute to read
  • Dark
    Light

Authentication API

  • Dark
    Light

Article summary


Introduction


This article provides the API specifications for the Authentication API.

Looking for More?
For instructions on how to use the Authentication API to check out the Authenticity of a LeadiD token, check out the Intelligence Response Glossary article.

Example Request Structure (GET method)


https://api.leadid.com/Authenticate?lac={ACCOUNTCODE}&id={LEADIDTOKEN}

Test Values
Using "test" values for consumer data when creating the LeadiD token may result in a "Not Authentic" response



Parameter Definitions


NameValueRequiredDescription
URLhttps://api.leadid.com/AuthenticateYesThe URL to be used for the query.
MethodGET
YesThe HTTPS method to be used.
lacxxxxxxxx-xxxx-xxxx-xxxx
Yes
Your Jornaya Account Code.
id36 Character LeadiD token
Yes
The LeadiD token, which must be included in every query.


Security for Usage


The usage of HTTPS/TLS is highly recommended when implementing the Jornaya TCPA Guardian (3rd Party) API. This ensures data transmitted between your networks and Jornaya’s systems are securely encrypted and protected. Jornaya supports the usage and configuration of TLS 1.2, and the following TLS cipher suites:

ECDHE-ECDSA-AES128-GCM-SHA256ECDHE-RSA-AES256-SHA384
ECDHE-RSA-AES128-GCM-SHA256ECDHE-RSA-AES256-SHA
ECDHE-ECDSA-AES128-SHA256ECDHE-ECDSA-AES256-SHA
ECDHE-RSA-AES128-SHA256AES128-GCM-SHA256
ECDHE-ECDSA-AES128-SHAAES128-SHA256
ECDHE-RSA-AES128-SHAAES128-SHA
ECDHE-ECDSA-AES256-GCM-SHA384AES256-GCM-SHA384
ECDHE-RSA-AES256-GCM-SHA384AES256-SHA256
ECDHE-ECDSA-AES256-SHA384
Revisions

At any future time, Jornaya may revise the list of supported TLS protocols and cipher suites as required by industry security best practices. You will be notified in advance of such changes to ensure continued successful operations of your integrations with Jornaya’s services.


Example Response Structure


JSONXML
{<authenticate>
     "authenticate": {    <authentic>1</authentic>
                    "authentic": 1,    <token>{LeadiD}</token>
                     "token": "{LeadiD"</authenticate>
               }    
}  

Data Responses

The following sections list the responses (and associated values) received when utilizing the Authentication API.


Audit

Data PointValueDescription
token{LeadiD token}The LeadiD token being returned


Authentic

Data PointValueDescription
authentic0One or more of the conditions have been met below and no additional data will be returned for this LeadiD token:
  • This was not a token that Jornaya created.
  • This token has been queried too many times (i.e. hundreds or thousands of times) when Jornaya’s partners performed an API call to our system.
  • This token was created over a year ago. 
  • This token is associated witha consumer who has exercised their CCPA Right to Opt-out.

1Authentic LeadiD


Was this article helpful?