API de verificación de SSN en Estados Unidos: validez, estado emisor y año de emisión

Actualizado en noviembre de 2026

Esta guía muestra cómo verificar SSN en Estados Unidos con la API de Verifik: el endpoint, sus parámetros, una solicitud que puedes pegar en la terminal, la respuesta y los errores documentados, y qué revisar al llevarlo a producción. Todo lo que sigue proviene de la documentación oficial del endpoint.

Sobre el documento: SSN en Estados Unidos

El número de Seguro Social (SSN) es un número de nueve dígitos (formato AAA-GG-SSSS) que asigna la Administración del Seguro Social (SSA). Nació para registrar ingresos para beneficios sociales, pero hoy prestamistas, empleadores y fintechs lo usan como identificador principal en el onboarding y en los expedientes de crédito en EE. UU.

Desde el 25 de junio de 2011 la SSA asigna los números de forma aleatoria. Antes de esa fecha, los tres primeros dígitos dependían del estado de emisión; por eso la respuesta puede incluir un estado emisor y un primer año de emisión. Para números asignados después de la aleatorización, trata esos dos campos solo como informativos.

¿Quieres probarlo? Crea tu cuenta en Verifik y haz tu primera consulta hoy.

Cómo consultar la API de SSN de Estados Unidos

Endpoint: GET https://api.verifik.co/v2/usa/ssn. Envía tu token en la cabecera Authorization: Bearer. Parámetros, según la documentación:

Ejemplo de solicitud con valores de ejemplo (reemplázalos por los datos de tu usuario):

curl --location --request GET 'https://api.verifik.co/v2/usa/ssn?documentNumber=123-45-6789' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>'

Respuesta 200 de la documentación (datos personales enmascarados):

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

Una consulta exitosa devuelve HTTP 200 con un objeto data que contiene: firstYearIssued, issuingState, SSN, valid. Toda respuesta incluye además una signature (fecha y “Certified by Verifik.co”) y un id único que puedes guardar como evidencia de la verificación.

Errores documentados de /v2/usa/ssn

• 401 UNAUTHORIZED (“Authentication required”): falta el token o no es válido; revisa la cabecera Authorization.
• 403 FORBIDDEN (“Access forbidden”): el token es válido pero no tiene acceso a este endpoint; revisa tu plan o permisos.
• 404 NotFound (“Record not found”): no se encontró registro; no lo trates como coincidencia y envía el caso a revisión o pide otro documento.
• 409 MissingParameter (“missing documentNumber”): falta un parámetro obligatorio o tiene un valor no válido; corrige la solicitud en vez de reintentarla igual.

Consejos de integración

• Envía el SSN tal como el solicitante lo escribió; la documentación pide el valor tal como aparece en el documento.
• Usa valid como campo de decisión. issuingState y firstYearIssued ayudan a detectar inconsistencias (por ejemplo, un SSN emitido décadas antes del nacimiento del solicitante merece revisión manual).
• La consulta del SSN confirma el número, no a la persona. Combínala con verificación de documento y selfie antes de aprobar cuentas de alto riesgo.
• Guarda el bloque signature junto a la decisión para demostrar cuándo y cómo se hizo la verificación.

Datos personales y términos de uso

Las consultas de identidad tratan datos personales. Usa la API solo con una finalidad legítima que puedas documentar, como onboarding, prevención de fraude o verificación contractual, obtén el consentimiento cuando la ley local lo exija y conserva solo los campos que necesites. El uso se rige por los términos y condiciones de smartCHECK.

Precios

Cada solicitud exitosa consume créditos de tu plan de Verifik. Los planes vigentes y el costo por endpoint están en la página de precios de smartCHECK.

Guías y documentación relacionadas

• API de consulta de empresas en EE. UU. (SEC EDGAR)
• Documentación del endpoint (español)
• Documentación en inglés

Empieza a probar

Crea una cuenta en Verifik para obtener tu token de API, o agenda una reunión si quieres revisar cobertura y volúmenes con el equipo.