---
title: "DOB Verification"
method: POST
path: "/api/dob/verify"
tags: ["dob"]
---

# DOB Verification

`POST /api/dob/verify`

DOB verification job

## Headers

- `content-type` string
- `accept` string

## Request body

- DobRequest
  - `firstName` string, required — First name linked to this phone number in the request. The request must contain the firstname or lastname to be successful
  - `lastName` string, required — Last name linked to the phone number in the request. The request must contain the firstname or lastname to be successful
  - `phone` string, required — The phone number of the individual for this request. Only accepts US and CA numbers. Must be in E.164 format with or without a leading +1. For example `+11234567890` or `1234567890`.
  - `email` string — Email linked to the phone number in the request
  - `dob` string, required — Date of birth identifier used as qualifying input. Date should be in ISO 8601 format https://en.wikipedia.org/wiki/ISO_8601 YYYY-MM-DD. For example, `1990-01-30`.
  - `address` DobAddress — The primary address to verify against ownership of the phone number. Only US and CA addresses are accepted.
    - `unit` string — Unit number.
    - `streetAddress` string — Street Address.
    - `city` string — City.
    - `state` string — Two-character region code for US states or Canadian provinces/territories (e.g., NY, CA, ON, BC). Use official postal abbreviations for the selected country.
    - `postalCode` string — Postal Code.
    - `country` 'US' | 'CA' — Must be either US or CA.

## Response `200`

Success

- DobResponse
  - `id` string
  - `status` string
  - `completed` boolean
  - `submitted` string
  - `updatedAt` string
  - `request` object
    - `type` string
    - `paramaters` object
      - `phone` string
  - `result` object
    - `dobMatch` boolean
  - `errors` DobError[] — List of errors for unsuccessful completed dob jobs.
    - `type` 'InvalidRequestError' | 'AuthenticationError' | 'ConnectionError' | 'UnknownSystemError' | 'TooManyRequestsError' — Error type code. - InvalidRequestError - The request is invalid. - Parameters sent in the request are invalid. - AuthenticationError - The request could not be authenticated. - The key could not be verified. - ConnectionError - A connection error occurred while communicating to the Vouched service. - UnknownSystemError - A unknown system error occurred. - TooManyRequestsError - the Vouched service has throttled this request. - Retry your request later.
    - `message` string — Details on the occurring error.
    - `warning` boolean — Is this a warning?
    - `suggestion` string — A suggestion for matching name.
  - `signals` unknown[] — List of signals affecting the request
    - unknown

## Other responses

- `400` — InvalidRequestError - The request is invalid.
- `401` — AuthenticationError - The request could not be authenticated.
- `404` — ConnectionError - A connection error occurred while communicating to the Vouched service.
- `429` — TooManyRequestsError - the Vouched service has throttled this request.
- `500` — UnknownSystemError - A unknown system error occurred.

---

[API](https://skmtc.dev/vouched/apis/vouched-api.md) · [All operations](https://skmtc.dev/vouched/apis/vouched-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/vouched/vouched-api/revisions/e6b14826bf7f/schema)