Identifiers

An identifier is a phone number or email address the user uses to verify for 1-Click Signup.

Identifiers are inputs: users input them and/or you pass them to us in API request bodies.

note

To source verified data (credentials and metadata) for a user:

• 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).
• Birth date and/or SSN4 are only required sometimes: if you get the OCE11 error code, which indicates that additional information is required. This happens when Verified is unable to narrow down to a single user based on only phone (and email if included).

Name	Key	Type	Format	Description	Example
Phone	phone	string	E.164	Phone number a user uses to verify for 1-Click Signup	"+12125550010"
Email	email	string	email	Email address a user uses to verify for 1-Click Signup	"richard@piedpiper.net"
Birth Date	birthDate	string	YYYY-MM-DD	User's birth date (in Sandbox, this must be "1989-08-01" to pass validation)	"1989-08-01"
SSN4	ssn4	string	4 digits (0-9)	Last 4 digits of user's Social Security Number (in Sandbox, this must be "6789" to pass validation)	"6789"