JSON Request Properties

The request body accepts a MinimumAgeRequired threshold and a set of optional identifier fields used to resolve the subject's identity. All identifier fields are strings; omit those you do not have by leaving them as an empty string ("").

❗️

At least one identifier required

You must supply at least one of FirstName+LastName, Phone, Email, DOB, SSN, or AddressLine1. Requests with only MinimumAgeRequired will return an input error.

Age threshold

Field	Type	Required	Description
MinimumAgeRequired	integer	✅	The minimum age the subject must meet. The response's minimumAgeMet field will be true only if the matched subject's age is greater than or equal to this value. Common values: 18 (tobacco, adult content, firearms in some states), 21 (alcohol, cannabis, gambling).

Identity

Field	Type	Description
FirstName	string	Subject's first name. Pair with LastName to resolve by name.
MiddleName	string	Subject's middle name or initial. Optional; used to improve match precision when multiple candidates share a first/last name.
LastName	string	Subject's last name. Required when resolving by name.
DOB	string	Date of birth. Accepted formats include MM/DD/YYYY and YYYY-MM-DD. When supplied, DOB is used both to resolve identity and to compute age directly — the strongest signal for age verification.
SSN	string	Social Security Number. Full or last 4 digits accepted.

Contact

Field	Type	Description
Phone	string	10-digit phone number, digits only (no dashes, spaces, or country code).
Email	string	Email address associated with the subject.

Address

Field	Type	Description
AddressLine1	string	Street number and street name (e.g., "123 Main St").
AddressLine2	string	Unit, apartment, or suite designator. Optional.

Example request

JSON

{
  "MinimumAgeRequired": 21,
  "FirstName": "Shawn",
  "MiddleName": "",
  "LastName": "Hazen",
  "Phone": "5304974046",
  "Email": "",
  "DOB": "",
  "SSN": "",
  "AddressLine1": "",
  "AddressLine2": ""
}