Inputs
An input is a piece of data you pass to the SDK or API.
To source verified data (outputs) for a user:
- Identifiers: Phone is always required. Email is optional, but including it helps source better and more metadata — especially risk signals. It cannot be used on its own to source credentials (user identity data).
- Challenges: These are only required sometimes: if you get the
OCE11error code, which indicates that additional information is required. This happens when Verified is unable to narrow down to a single user based on the inputs already provided. - Other Inputs: These are optional. For name, we'll try to match against all names we find associated with the user. This often means, for example, that a user's nickname will match as well as their legal name, but that depends on which names we can source for the user.
Identifiers
An identifier is a piece of user data that's used as a primary lookup for outputs and must match the outputs.
| Name | Key | Required? | Type | Format(s) | Description | Example |
|---|---|---|---|---|---|---|
| Phone | phone | required | string | E.164 | Phone number a user uses to verify for 1-Click Signup | "+12125550010" |
email | optional | string | Email address a user uses to verify for 1-Click Signup | "richard@piedpiper.net" |
Challenges
A challenge is a piece of user data that's used as a secondary lookup for outputs and must match the outputs.
Unlike other inputs, challenges must match the outputs sourced for a user. In other words, they have to match the records we find for a user, or you'll get an OCE012 error. That's because birth dates and SSN4s don't vary, while names and addresses do. For example, a user may enter a nickname rather than their legal name, or they might have recently moved.
| Name | Key | Required? | Type | Format(s) | Description | Example |
|---|---|---|---|---|---|---|
| Birth Date | birthDate | optional (but required after some OCE011 errors) | string | YYYY-MM-DD | User's birth date (in Sandbox, this must be "1989-08-01" to pass validation) | "1989-08-01" |
| SSN4 | ssn4 | optional (but required after some OCE011 errors) | string | 4 digits (0-9) | Last 4 digits of user's Social Security Number (in Sandbox, this must be "6789" to pass validation) | "6789" |
Other Inputs
An other input is a piece of user data that's used as an additional lookup for outputs and does not have to match the outputs.
Unlike challenges, these other inputs do not have to match the outputs sourced for a user. That's because names and addresses vary, while birth dates and SSN4s don't. For example, a user may enter a nickname rather than their legal name, or they might have recently moved.
| Name | Key | Required? | Type | Format(s) | Description | Example |
|---|---|---|---|---|---|---|
| Full Name | fullName | optional | Object | Object with keys for one or more child credentials listed below | Full name | |
| ↳ First Name | fullName.firstName | optional | string | cAse inSensiTive | First name | "Richard" |
| ↳ Middle Name | fullName.middleName | optional | string | cAse inSensiTive | Middle name | "Harrison" |
| ↳ Last Name | fullName.lastName | optional | string | cAse inSensiTive | Last name | "Hendricks" |
| Address | address | optional | Object | Object with keys for one or more child credentials listed below | Address | |
| ↳ Line 1 | address.line1 | optional | string | cAse inSensiTive | Line 1 of address | "5320 Newell Rd" |
| ↳ Line 2 | address.line2 | optional | string | cAse inSensiTive | Line 2 of address | "" |
| ↳ City | address.city | optional | string | cAse inSensiTive | City of address | "Palo Alto" |
| ↳ State | address.state | optional | string |
| State of address |
|
| ↳ ZIP Code | address.zipCode | optional | string | ZIP Code of address |
| |
| ↳ Country | address.country | optional | string |
| Country of address |
|