> ## Documentation Index
> Fetch the complete documentation index at: https://sdk.transcrypts.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create an Instant Verification

> Submit a new instant verification request for employment and income data

## 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

| Parameter               | Type   | Required | Description                                          |
| ----------------------- | ------ | -------- | ---------------------------------------------------- |
| `subject`               | object | Yes      | The person to verify                                 |
| `subject.first_name`    | string | Yes      | First name of the subject                            |
| `subject.last_name`     | string | Yes      | Last name of the subject                             |
| `subject.date_of_birth` | date   | Yes      | Date of birth in YYYY-MM-DD format                   |
| `subject.ssn`           | string | No       | Social Security Number, last 4 digits or full        |
| `addresses`             | array  | Yes      | At least one address entry                           |
| `addresses[].street`    | string | Yes      | Street address                                       |
| `addresses[].city`      | string | Yes      | City                                                 |
| `addresses[].state`     | string | Yes      | State                                                |
| `addresses[].zip`       | string | Yes      | Zip code                                             |
| `addresses[].country`   | string | No       | Country (default: "US")                              |
| `addresses[].from_date` | date   | Yes      | Date the subject began residing at this address      |
| `addresses[].to_date`   | date   | No       | Date the subject left this address (null if current) |
| `tracking_info`         | string | No       | Client-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

```json theme={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"
    }
  ],
  "tracking_info": "app-ref-98765"
}
```

## Example Response

```json theme={null}
{
  "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"
}
```

## Related Endpoints

* [Instant Verification object](instant-verification) - Object attributes and data structure
* [Retrieve an instant verification](instant-verification-retrieve) - GET endpoint for retrieving a verification
* [List all instant verifications](instant-verification-list) - GET endpoint for listing verifications
* [Instant Verification webhooks](instant-verification-webhooks) - Webhook notifications for verification events