The SSN Verification Service is a robust tool designed to verify Social Security Numbers (SSN) issued in the United States. This service allows users to quickly validate an SSN by providing details such as the issuing state and the first year of issuance. The response includes the SSN itself, the year it was first issued, the issuing state, and the validity status of the SSN. This tool is essential for ensuring the accuracy and authenticity of Social Security Numbers.

Parameters

Name Type ¿Required? Description Example
documentNumber String True SSN to be queried, it must be written exactly as it appears on the document. 123-45-678

Implementation

Request

import axios from 'axios';

const options = {
  method: 'GET',
  url: '<https://api.verifik.co/v2/usa/ssn>',
  params: {documentNumber: '123-45-678'},
  headers: {
    Accept: 'application/json',
    Authorization: 'jwt <tu_token>'
  }
};

try {
 notFou const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

Response 200 - (Successful response)

{
  "data": {
    "firstYearIssued": "1936",
    "issuingState": "Oklahoma (OK)",
    "SSN": "123-45-678",
    "valid": true
  },
  "signature": {
    "dateTime": "April 11, 2023 3:42 PM",
    "message": "Certified by Verifik.co"
  }
}

Other responses

Code Description Response Body
404 Not Found Information not found.

| { "code": "NotFound", "message": "Record not found.", "signature": { "dateTime": "August 31, 2022 3:24 PM", "message": "Certified by Verifik.co" } } | | 409 | Conflict | Some parameters are missing.

| { "code": "MissingParameter", "message": "missing documentNumber\ n"} |