LogoLogo
Sign InCertnCertn Help
Certn API
Certn API
  • Certn API
  • Getting Started
    • Request a demo account
      • Get your access token
      • Understand your general resources
      • Create your first application
      • Retrieve the results
  • Guides
    • Manage your settings
    • Manage your integration users
    • Use the API
      • Get and use an Authorization Token
      • Use webhooks
        • Webhook parameters and example
      • Get the applicant's consent
    • Run a check
      • Address Reference Check
      • Australia Right To Work Check
      • Basic Disclosure And Barring Service Check
      • Basic Disclosure Scotland Check
      • Canadian Criminal Record Check
      • Credential Verification
      • Credit Check
      • Education Verification
      • Employment Verification
      • Employment Reference Check
      • Enhanced Identity Verification
      • International Criminal Record Check
      • Motor Vehicle Record Check / Driver's Abstract
      • Softcheck
      • Social Media Check
      • SOQUIJ
      • UK Right To Work Check
      • US Criminal Record Check
    • Understanding statuses and scores
  • API Reference
    • Settings and packages
    • Human Resources
      • Available checks
    • Property Management
      • Available checks
    • Resources
      • Application parameters
        • Request flags
        • Package settings
      • Error codes
      • Regional codes
      • Report field mappings
  • FAQ
  • Changelogs
  • Contact us
Powered by GitBook

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 support@certn.co. ©2023 Certn.

On this page
  • Availability
  • Parameters
  • Report

Was this helpful?

Export as PDF
  1. Guides
  2. Run a check

Enhanced Identity Verification

PreviousEmployment Reference CheckNextInternational Criminal Record Check

Last updated 1 year ago

Was this helpful?

If you integrated prior to March 1, 2023 with our redirect URL approach, please let us know you are ready for the changes at 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

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:

    • first_name

    • last_name

    • date_of_birth

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

Submit the required documents via these fields:

    • id_country

    • id_type

    • id_frontside_image

    • id_backside_image (not required for PASSPORT type)

    • face_image

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. Send your request with the main quickscreen parameters

    • You have the option to include the on_success_url parameter in your request to redirect your applicant to your preferred URL when they complete their verification flow.

        • on_success_url

  2. In the response, find enhanced_identity_verification.

  3. Copy the value of redirect_url.

  4. Share the redirect URL with your applicant.

  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.

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 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
            },
        ],
    },
    "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 (when optional input was not provided)

"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 (when optional input was provided)

"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

(min 1)

Make sure to obtain the from your applicant before running the quickscreen.

Send your images as encoded objects.

If you don't provide the on_success_url parameter in your request, your applicant will be directed to a default when they complete their verification flow.

If you're embedding this in an iframe, to provide the domain in which it will be embedded.

Report field:

proof of consent
base64
thank you page
contact our support team
🇨🇦
🇺🇸
✅
api@certn.co
request_enhanced_identity_verification
✅
📩
✅
📩
✅
📩
✅
📩
quickscreen
enhanced_identity_verification
information
addresses
position_or_property_location
enhanced_identity_verification
enhanced_identity_verification
Quickscreen
Invite
Quickscreen
Invite
Quickscreen
Invite
Quickscreen
Invite