Skip to main content

1-Click or Free IDV

Time to read: 5 min

Time to implement: 30 - 60 min


You will need an API key and an email and/or phone for each user. Below is a valid API Key for your initial usage along with suggested test email and phone values.

Sandbox API Key
Sandbox User Email
Sandbox User Phone

Verified Inc. enables 1-Click or Free ID Verification (IDV), powered by our digital ID cards.

You can implement any of the following:

  • Free IDV Only: You issue a digital ID card to any of your users (new or existing), and we pay you for it.

    Demo of Free Only

    Richard is an existing, verified Hooli user. The next time he signs in, Hooli asks him if he wants to activate his Hooli digital ID card. When he clicks the Activate button, Hooli issues the card, and Verified Inc. reimburses Hooli for the cost of the identity verification performed by Hooli for Richard.

  • 1-Click IDV only: If a user has a digital ID card, they can verify with 1-Click. If they don't, you take them through your existing verification process (no change needed).

    Demo of 1-Click Only

    This demo shows Kredita using 1-Click IDV when it's available. They collect email and phone from the user (Richard) and check if the user has matching credentials. The user does, so Kredita lets them verify with 1-Click.

  • Both: If a user has a digital ID card, they can verify with 1-Click. If they don't, you take them through your existing verification process (no change needed) — and at the end you issue them a digital ID card, and we pay you for it.

What do you want to implement?

You need to issue

A credential is a collection of data about a person. It's issued by a company and can be requested by other network participants, gated by the user's consent.
Example: ACME Lending issues a KYC verification credential to Richard (an ACME user). This includes Richard's contact information and account numbers, as well as a level of confidence in the accuracy of the data.
Components: A company issues credentials following the steps in the Issuance Guide.
credentials to a user. When you do, Verified Inc. will pay you according to your contract.

  1. Get user consent. Ask the user if they want to activate their digital ID card (from your brand), and include Verified Inc. legal language:

    By clicking the button below, you agree to Verified Inc.’s Terms of Use and direct YOUR_COMPANY_NAME to share your personal information with Verified Inc. to provide its digital ID card services, in accordance with its Privacy Policy.

    "Terms of Use" should be underlined or colored and hyperlinked to "Privacy Policy" should be underlined or colored and hyperlinked to


    You must obtain user consent before issuing credentials. Not doing so violates our terms and will prevent us from paying you for issuing credentials.

  2. Call /credentials with the user's verified email and/or phone and one or more credentials. For each credential, include a type and data in accordance with one of our schemas.

    If we don't have a schema that suits your needs, email us and we'll make one for you.

    For example, if you have a verified Social Security Number (SSN) for a user, you can issue them a SsnCredential. Just call the /credentials endpoint with the user's email and/or phone, the SsnCredential type, and the SSN data:

    Example Issue Credentials Request Body
    "email": "",
    "phone": "+10123456789",
    "credentials": [
    "type": "SsnCredential",
    // based on the properties attribute of the schema
    "data": {
    "ssn": "111223333"
    "expirationDate": 1893484800

    Format the credential data according to the properties attribute of the credential schema. In this case, the schema is for a SsnCredential which can found found at

    More information about credential schemas can be found in the Schema section.

    You're done!

    For more detailed information on how and why to implement Free IDV, see our Free IDV Guide.