Certn API
Search
K
Links

Enhanced Identity Verification

If you integrated prior to March 1, 2023 with our redirect URL approach, please let us know you are ready for the changes at [email protected] by March 31, 2023.
An enhanced identity verification check establishes the real identity of an individual by verifying government-issued identification documents instantly. Certn’s advanced technologies are proven to detect false identities while providing a seamless identification verification process and deterring fraud.​

Availability

This check is available in Canada
🇨🇦
and the US
🇺🇸
This check is available for a quickscreen
Canada
US
Industry
Availability
Endpoints
Human Resources
Yes
Property Management
Yes
Industry
Availability
Endpoints
Human Resources
Yes
Property Management
Yes

Parameters

Request flag

Include this flag in the body of your request:

Invite parameters

To invite an applicant to complete a screen, include this parameter in the body of your request:
  • email
See all available Application parameters

Quickscreen parameters

To complete a quickscreen, include these parameters in the body of your request:
Provide these additional documents as proof of identity:
  • A recent unaltered selfie
  • The front and back of a government-issued ID
Each picture must follow these rules:
  • Picture size is < 10MB
  • Longest side is > 300 pixels
  • Each side is < 8000 pixels
Make sure to obtain the proof of consent from your applicant before running the quickscreen.
Add the documents in your original request
Ask your applicant to upload the documents via redirect URL
Submit the required documents via these fields:
Send your images as base64 encoded objects.

Example request with required documents

{
"request_enhanced_identity_verification": true,
"information": {
"first_name": "Andrew",
"last_name": "McLeod",
"addresses": [{
"address": "4412 King Alfred Court",
"city": "Victoria",
"province_state": "BC",
"country": "CA",,
"current": true
},
],
},
"enhanced_identity_verification": {
"id_country": "CA",
"id_type": "DRIVING_LICENSE",
"id_frontside_image": "<base64 encoded image>",
"id_backside_image": "<base64 encoded image>",
"face_image": "<base64 encoded image>"
},
"position_or_property_location": {
"address": "Tiffany & Co., 97 Greene St",
"city": "New York City",
"county": "New York",
"province_state": "NY",
"country": "US",
"postal_code": "10012",
"location_type": "Position Location"
}
}
The following configuration will be in effect starting March 1, 2023
  1. 1.
    Send your request with the main quickscreen parameters
    • Optionally, include the on_success_url parameter in your request to redirect your applicant to your preferred URL when they complete their verification flow
    • If the on_success_url parameter isn't provided in your request, your applicants will be directed to a default thank you page when they complete their verification flow
  2. 2.
    In the response, find enhanced_identity_verification
  3. 3.
    Copy the value of redirect_url
  4. 4.
    Share the redirect URL with your applicant
  5. 5.
    Ask your applicant to complete the verification flow via the provided URL
Certn will proceed with the identity verification once your applicant has successfully uploaded their documents.
If you're embedding this in an iframe, contact our support team to provide the domain in which it will be embedded.
Within your iframe, include the following attributes to enable the camera for image capture in full-screen mode allow="camera;fullscreen;accelerometer;gyroscope;magnetometer" allowfullscreen

Example request without the optional input

{
"request_enhanced_identity_verification": true,
"information": {
"first_name": "Andrew",
"last_name": "McLeod",
"addresses": [{
"address": "4412 King Alfred Court",
"city": "Victoria",
"province_state": "BC",
"country": "CA",
"current": true
},
],
},
"position_or_property_location": {
"address": "Tiffany & Co., 97 Greene St",
"city": "New York City",
"county": "New York",
"province_state": "NY",
"country": "US",
"postal_code": "10012",
"location_type": "Position Location"
}
}
Example response with redirect URL
"enhanced_identity_verification": {
"id": "1e542c5c-f9af-4e6f-8d27-f19dd8682fd7",
"created": "2019-11-11T16:00:00.000000Z",
"modified": "2019-11-11T16:00:00.000000Z",
"status": "P",
"result": "None",
"reasons": ["Verification Status Not Set"],
"identity": {
"name": {
"first_name": null,
"last_name": null,
},
"date_of_birth": null,
"current_address": null,
},
"status_label": "Pending",
"result_label": "None",
"redirect_url": "https://app.certn.co/one_id?session=XpZNFlUZ3dJaXdpYVdGMElqb3hOamMxTXpZd01ETXpmUS5nbnVXZlQ4enQ3bkF5ODFQWjF&lang=en"
"front": null,
"back": null,
"face": null,
}
The verification sessions expire 7 days after creation. If it has expired, please order a new enhanced identity verification check for a new session.

Example request with the optional redirect URL input

{
"request_enhanced_identity_verification": true,
"information": {
"first_name": "Andrew",
"last_name": "McLeod",
"addresses": [{
"address": "4412 King Alfred Court",
"city": "Victoria",
"province_state": "BC",
"country": "CA",
"current": true
},
],
},
"enhanced_identity_verification": {
"on_success_url": "https://certn.co/"
},
"position_or_property_location": {
"address": "Tiffany & Co., 97 Greene St",
"city": "New York City",
"county": "New York",
"province_state": "NY",
"country": "US",
"postal_code": "10012",
"location_type": "Position Location"
}
}
Example response with redirect URL including the on_success_url
"enhanced_identity_verification": {
"id": "1e542c5c-f9af-4e6f-8d27-f19dd8682fd7",
"created": "2019-11-11T16:00:00.000000Z",
"modified": "2019-11-11T16:00:00.000000Z",
"status": "P",
"result": "None",
"reasons": ["Verification Status Not Set"],
"identity": {
"name": {
"first_name": null,
"last_name": null,
},
"date_of_birth": null,
"current_address": null,
},
"status_label": "Pending",
"result_label": "None",
"redirect_url": "https://app.certn.co/one_id?session=XpZNFlUZ3dJaXdpYVdGMElqb3hOamMxTXpZd01ETXpmUS5nbnVXZlQ4enQ3bkF5ODFQWjF&lang=en&on_success_url=https://certn.co/"
"front": null,
"back": null,
"face": null,
}
If you integrated prior to March 1, 2023, be advised that the domain forredirect_url was https://certn.netverify.com instead of https://app.certn.co

Report

The Certn Group of companies includes Certn, Credence & InterCheck. For educational purposes, these companies are referred to as “Certn” in this website. For questions about any of the aforementioned companies, contact [email protected]. ©2023 Certn.