SSN Check

post

https://verify.vouched.id/api/private-ssn/verify

Private SSN verification job. The returned id is the job identifier; pass it to GET /api/private-ssn/jobs/{id} to retrieve the stored job record.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

📘
Accented and diacritic characters are supported.
Vouched automatically normalizes them in name and address fields (firstName, lastName, streetAddress, city) before verification

📘
For testing purposes please use Test Accounts as fields that are properly formatted but invalid (like phone numbers +19999999999) will not pass

Body Params

firstName

string

required

length between 1 and 50

First name linked to this phone number in the request. The request must contain the firstname or lastname to be successful

lastName

string

required

length between 1 and 50

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. Formatted in E.164 formatting for international numbers including the leading plus sign. For example +12065551111

ssn

string

required

^(\d{4}|\d{9})$

The last 4 or full 9 digits of the social security number in the request

string

Email linked to the phone number in the request

dob

string

Date of birth identifier used as qualifying input. Date should be in ISO 8601 format https://en.wikipedia.org/wiki/ISO_8601

address

object

The primary address line to verify against ownership of the phone number

consentStatus

boolean | null

Denotes whether the mobile subscriber has consented to this transaction. Forwarded to the verification provider.

properties

Arbitrary customer supplied properties, either a single string or a list of name/value pairs.

Headers

x-test-request

string

Defaults to false

Set value to true to test a request using test SSNs. The following SSN values will result in ssnMatch=true ['2345', '2245', '7788', '903526700', '912765604', '933887700']. Any other SSN will result in ssnMatch=false.

Responses

200Success

400InvalidRequestError - The request is invalid. An aborted or oversized request is answered with this status and an empty body instead of the envelope below.

401The request could not be authenticated. Credential rejection returns an AuthenticationError envelope; a malformed or expired bearer token is rejected earlier by the JWT middleware and returns { "error": "Token expired" } or { "error": "Token malformed" } instead.

403SSNAccountConfigErrorType - SSN verification is not enabled for this account. The SSN endpoints return this type in place of the AccountConfigErrorType used everywhere else.

500UnknownSystemError - A unknown system error occurred.