---
title: "eCBSV Check"
method: POST
path: "/api/ecbsv-ssn/verify"
tags: ["ssn"]
---

# eCBSV Check

`POST /api/ecbsv-ssn/verify`

Post an eCBSV SSN verification job. eCBSV SSN jobs are reserved for qualifying financial institutions only.

## Headers

- `content-type` string
- `accept` string
- `x-test-request` string

## Request body

- EcbsvSsnRequest
  - `ein` string, required — Employer Identification Number of the entity that obtained the number holder consent for matching in the verification service. Must be numeric.
  - `cvsRequestList` object[], required
    - `ssn` string — Person's SSN (must be a string with 9 digits only)
    - `dateOfBirth` string — Person's DOB (mmddyyyy)
    - `lastName` string — Lastname linked to the ssn in the request (1 to 20) characters. Alphabetic characters only. Replace any numbers, hyphens, slashes, or other characters with a space.
    - `firstName` string — Firstname linked to the ssn in the request (1 to 15) characters. Alphabetic characters only. Replace any numbers, hyphens, slashes, or other characters with a space.
    - `middleName` string — Middlename linked to the ssn in the request (1 to 15) characters. Alphabetic characters only. Replace any numbers, hyphens, slashes, or other characters with a space.
    - `additionalParams` object
      - `signatureType` 'W' | 'E'

## Response `200`

Success

- EcbsvSsnResponse
  - `errorCode` string
  - `errorCodeDesc` string
  - `cvsResponseList` object[]
    - `verificationCode` 'Y' | 'N'
    - `verificationData` object
      - `deathIndicator` 'Y' | 'N'
    - `recordErrorCode` string
    - `recordErrorCodeDesc` string
    - `cvsRequest` object
      - `externalSeqNumber` string

## 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.
- `422` — UnprocessableContentError - The request contains incorrectly formatted or missing data.
- `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)