us_ssn_card

Tarjeta de la Seguridad Social de EE. UU. (SSN)

Estructura del SSN, titular y leyendas de restricción laboral.

Categoría: Identidad
País: Estados Unidos
Campos que extrae: 4 campos
Coste: 1 crédito

us_ssn_cardspecimen

Número de la Seguridad Social (SSN)
Nombre del titular
Restriction
Firma presente

Constaia lee el número de la Seguridad Social y el nombre, aplica las reglas de estructura del SSN y detecta leyendas restrictivas como "Valid for work only with DHS authorization".

Un SSN con estructura válida no prueba que pertenezca a esa persona.

Qué comprueba

Identificadores nacionales. Checksum o formato oficial del número (NIF, CPF, CURP, RUT, codice fiscale…).us_ssn
Titular. Nombre, número o fecha de nacimiento coinciden con lo esperado.
Formulario I-9. Indica si el documento es de la lista A, B o C.C

Campos que extrae

Número de la Seguridad Social (SSN)ssn
Nombre del titularholder_name
Restrictionrestriction
Firma presentesignature_present

Petición de ejemplo

curl https://api.constaia.com/v1/analyze \
  -H "Authorization: Bearer $CONSTAIA_API_KEY" \
  -F "file=@us_ssn_card_specimen.jpg" \
  -F 'options={
    "expect": "us_ssn_card",
    "checks": {
      "holder": {
        "full_name": "Jordan Specimen"
      }
    },
    "storage": "none"
  }'

Pruébalo sin coste con una clave ck_test_ y el fichero us_ssn_card_specimen.jpg.

Ejemplo de respuesta

Datos ficticios. Respuesta abreviada.

200 OK · application/json

{
  "id": "an_01J9Z3K8QW4T6Y2B7N5M1R0PXC",
  "object": "analysis",
  "status": "completed",
  "livemode": false,
  "document": {
    "type": "us_ssn_card",
    "label": "Tarjeta de la Seguridad Social de EE. UU. (SSN)",
    "confidence": 0.97
  },
  "verdict": {
    "expected": [
      "us_ssn_card"
    ],
    "match": true,
    "status": "valid",
    "reasons": [
      {
        "code": "type_match",
        "severity": "info",
        "message": "El documento es: Tarjeta de la Seguridad Social de EE. UU. (SSN)."
      }
    ]
  },
  "fields": {
    "ssn": {
      "value": "123-45-6789",
      "confidence": 0.99,
      "validated": true
    },
    "holder_name": {
      "value": "JORDAN LEE SPECIMEN",
      "confidence": 0.98,
      "validated": null
    },
    "work_restriction_legend": {
      "value": null,
      "confidence": 0.97,
      "validated": null
    },
    "signature_present": {
      "value": true,
      "confidence": 0.96,
      "validated": null
    }
  },
  "checks": [
    {
      "code": "ssn_format",
      "passed": true,
      "message": "El SSN tiene una estructura válida."
    },
    {
      "code": "holder_match",
      "passed": true,
      "message": "El titular coincide."
    }
  ],
  "warnings": [],
  "storage": {
    "mode": "none",
    "file_deleted_at": "2026-09-29T10:00:02Z",
    "expires_at": null
  },
  "usage": {
    "credits": 1,
    "pages": 1
  }
}

FAQ

¿Constaia prueba que el documento es auténtico?

No. Comprueba el tipo, la coherencia de los datos y tus reglas, y avisa de señales como posible edición o foto de pantalla. Eso no prueba autenticidad.

¿Se guarda una copia del documento?

No, salvo que lo pidas. Con storage "none" (por defecto) el fichero se borra al terminar el análisis.

Otros documentos

Y para que conste…

Crea tu cuenta, copia la clave de test y valida tu primer documento en cinco minutos.

Crear cuenta gratis Hablar con ventas