🇺🇸 Estados Unidos — Verificação de SSN (Social Security Number)

A API de verificação de SSN da Verifik permite autenticar números de Seguro Social emitidos nos Estados Unidos com base em dados oficiais. É adequada para fluxos de KYC, prevenção a fraudes e exigências regulatórias em que a validade do SSN precisa ser confirmada.

O que esta API valida?

A API consulta registros oficiais para retornar informações como:

• SSN: dados associados à autenticidade do número.
• Estado emissor: indicação do estado de emissão, quando disponível.
• Ano da primeira emissão: primeiro ano em que o SSN foi emitido.
• Status de validade: se o número é considerado válido/ativo segundo a fonte.

Referência da API

Endpoint

GET https://api.verifik.co/v2/usa/ssn

Valide um SSN dos EUA passando o número no parâmetro de consulta documentNumber, exatamente como aparece no documento (incluindo hífens, se aplicável).

Cabeçalhos

Nome	Valor
Content-Type	application/json
Authorization	Bearer <token>

Parâmetros

Nome	Tipo	Obrigatório	Descrição	Exemplo
documentNumber	string	Sim	SSN a consultar, no mesmo formato do documento.	123-45-678

Requisição

JavaScript

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': 'Bearer <seu_token>'
  }
};

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

Python

import http.client

conn = http.client.HTTPSConnection("api.verifik.co")
payload = ''
headers = {}
conn.request("GET", "/v2/usa/ssn?documentNumber=123-45-678", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

PHP

<?php
require_once 'HTTP/Request2.php';
$request = new HTTP_Request2();
$request->setUrl('https://api.verifik.co/v2/usa/ssn?documentNumber=123-45-678');
$request->setMethod(HTTP_Request2::METHOD_GET);
$request->setConfig(array(
  'follow_redirects' => TRUE
));
try {
  $response = $request->send();
  if ($response->getStatus() == 200) {
    echo $response->getBody();
  }
  else {
    echo 'Unexpected HTTP status: ' . $response->getStatus() . ' ' .
    $response->getReasonPhrase();
  }
}
catch(HTTP_Request2_Exception $e) {
  echo 'Error: ' . $e->getMessage();
}
?>

Swift

var request = URLRequest(url: URL(string: "https://api.verifik.co/v2/usa/ssn?documentNumber=123-45-678")!,timeoutInterval: Double.infinity)
request.httpMethod = "GET"

let task = URLSession.shared.dataTask(with: request) { data, response, error in
  guard let data = data else {
    print(String(describing: error))
    return
  }
  print(String(data: data, encoding: .utf8)!)
}

task.resume()

Resposta

200

{
  "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"
  }
}

401

{
  "message": "Authentication required",
  "code": "UNAUTHORIZED"
}

403

{
  "message": "Access forbidden",
  "code": "FORBIDDEN"
}

404

{
    "code": "NotFound",
    "message": "Record not found."
}

409

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