Skip to main content
POST
/
v1
/
instant-verifications
/
Create an Instant Verification
curl --request POST \
  --url https://api.example.com/v1/instant-verifications/

​
Description

Submit a new instant verification request by providing the subject’s personal information and address history. The API will return the verification object with a status of processing while results are being compiled.

​
Authentication

This endpoint requires API credentials to be provided in the request header:
  • X-Access-Client-ID (header)
  • X-Access-Secret (header)

​
Request Body

ParameterTypeRequiredDescription
subjectobjectYesThe person to verify
subject.first_namestringYesFirst name of the subject
subject.last_namestringYesLast name of the subject
subject.date_of_birthdateYesDate of birth in YYYY-MM-DD format
subject.ssnstringNoSocial Security Number, last 4 digits or full
addressesarrayYesAt least one address entry
addresses[].streetstringYesStreet address
addresses[].citystringYesCity
addresses[].statestringYesState
addresses[].zipstringYesZip code
addresses[].countrystringNoCountry (default: “US”)
addresses[].from_datedateYesDate the subject began residing at this address
addresses[].to_datedateNoDate the subject left this address (null if current)
tracking_infostringNoClient-side tracking reference

​
Response

Returns a 201 Created response with the Instant Verification object. The status field will be processing and results will be null until verification completes.

​
Example Request

{
  "subject": {
    "first_name": "Jane",
    "last_name": "Doe",
    "date_of_birth": "1990-05-14",
    "ssn": "1234"
  },
  "addresses": [
    {
      "street": "742 Evergreen Terrace",
      "city": "Springfield",
      "state": "IL",
      "zip": "62704",
      "country": "US",
      "from_date": "2021-03-01",
      "to_date": null
    },
    {
      "street": "100 Main St",
      "city": "Shelbyville",
      "state": "IL",
      "zip": "62565",
      "country": "US",
      "from_date": "2018-06-15",
      "to_date": "2021-02-28"
    }
  ],
  "tracking_info": "app-ref-98765"
}

​
Example Response

{
  "id": "iv_8f3a2b1c4d5e6f7a8b9c0d1e2f3a4b5c",
  "status": "processing",
  "created_at": "2025-09-15T14:30:00.000000Z",
  "completed_at": null,
  "subject": {
    "first_name": "Jane",
    "last_name": "Doe",
    "date_of_birth": "1990-05-14",
    "ssn": "1234"
  },
  "addresses": [
    {
      "street": "742 Evergreen Terrace",
      "city": "Springfield",
      "state": "IL",
      "zip": "62704",
      "country": "US",
      "from_date": "2021-03-01",
      "to_date": null
    },
    {
      "street": "100 Main St",
      "city": "Shelbyville",
      "state": "IL",
      "zip": "62565",
      "country": "US",
      "from_date": "2018-06-15",
      "to_date": "2021-02-28"
    }
  ],
  "results": null,
  "tracking_info": "app-ref-98765"
}