SSN Check

post

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

Private SSN verification job

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

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

properties

array of objects

List of arbitrary customer supplied properties

properties

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.

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

200Success

400InvalidRequestError - The request is invalid.

401AuthenticationError - The request could not be authenticated.

404ConnectionError - A connection error occurred while communicating to the Vouched service.

429TooManyRequestsError - the Vouched service has throttled this request.

500UnknownSystemError - A unknown system error occurred.