pt_citizen_card

Cartão de Cidadão (Portugal)

Documento de identidad portugués (Cartão de Cidadão), tarjeta con chip y MRZ TD1; incluye NIF, número de Seguridad Social (NISS) y de usuario del SNS en el reverso.

Categoría: Identidad
País: Portugal
Campos que extrae: 16 campos
Coste: 1 crédito

pt_citizen_cardspecimen

Número de documento
Nombre
Apellidos
Sexo
Nacionalidad
Fecha de nacimiento
Fecha de expedición
Fecha de caducidad
País emisor

Qué comprueba

MRZ ICAO 9303. Dígitos de control de la zona de lectura mecánica.
MRZ frente a lo impreso. La MRZ coincide con los datos visibles.
Identificadores nacionales. Checksum o formato oficial del número (NIF, CPF, CURP, RUT, codice fiscale…).pt_cc, pt_nif
Titular. Nombre, número o fecha de nacimiento coinciden con lo esperado.
Edad. Edad mínima o máxima calculada con la fecha de nacimiento.
Vigencia. No caducado en la fecha de referencia.

Campos que extrae

Número de documentodocument_number
Nombrefirst_name
Apellidoslast_name
Sexosex
Nacionalidadnationality
Fecha de nacimientobirth_date
Fecha de expediciónissue_date
Fecha de caducidadexpiry_date
País emisorissuing_country
Mrzmrz
Civil id numbercivil_id_number
Tax idtax_id
Social security numbersocial_security_number
Health numberhealth_number
Heightheight
Nombre de los padresparents

Petición de ejemplo

curl https://api.constaia.com/v1/analyze \
  -H "Authorization: Bearer $CONSTAIA_API_KEY" \
  -F "file=@document.pdf" \
  -F 'options={
    "expect": "pt_citizen_card",
    "checks": {
      "not_expired": true,
      "holder": {
        "full_name": "Carmen Especimen Ruiz"
      }
    },
    "storage": "none"
  }'

Ejemplo de respuesta

Datos ficticios. Respuesta abreviada.

200 OK · application/json

{
  "id": "an_01J9Z3K8QW4T6Y2B7N5M1R0PXC",
  "object": "analysis",
  "status": "completed",
  "livemode": false,
  "document": {
    "type": "pt_citizen_card",
    "label": "Cartão de Cidadão (Portugal)",
    "confidence": 0.97
  },
  "verdict": {
    "expected": [
      "pt_citizen_card"
    ],
    "match": true,
    "status": "valid",
    "reasons": [
      {
        "code": "type_match",
        "severity": "info",
        "message": "El documento es: Cartão de Cidadão (Portugal)."
      }
    ]
  },
  "fields": {
    "document_number": {
      "value": "12345678 9 ZZ1",
      "confidence": 0.99,
      "validated": true
    },
    "first_name": {
      "value": "MARIA",
      "confidence": 0.98,
      "validated": null
    },
    "last_name": {
      "value": "ESPÉCIME",
      "confidence": 0.97,
      "validated": null
    },
    "sex": {
      "value": "F",
      "confidence": 0.96,
      "validated": null
    },
    "nationality": {
      "value": "PRT",
      "confidence": 0.99,
      "validated": null
    },
    "birth_date": {
      "value": "1985-07-30",
      "confidence": 0.98,
      "validated": null
    },
    "issue_date": {
      "value": "2023-03-15",
      "confidence": 0.97,
      "validated": null
    },
    "expiry_date": {
      "value": "2033-03-14",
      "confidence": 0.96,
      "validated": null
    },
    "issuing_country": {
      "value": "PRT",
      "confidence": 0.99,
      "validated": null
    },
    "mrz": {
      "value": "I<PRT1234567897ZZ1<<<<<<<<<<<<\n8507309F3303148PRT<<<<<<<<<<<7\nESPECIME<<MARIA<<<<<<<<<<<<<<<",
      "confidence": 0.98,
      "validated": null
    },
    "civil_id_number": {
      "value": "12345678 9",
      "confidence": 0.97,
      "validated": null
    },
    "tax_id": {
      "value": "123456789",
      "confidence": 0.96,
      "validated": null
    },
    "social_security_number": {
      "value": "11234567890",
      "confidence": 0.99,
      "validated": null
    },
    "health_number": {
      "value": "123456789",
      "confidence": 0.98,
      "validated": null
    },
    "height": {
      "value": "1,68",
      "confidence": 0.97,
      "validated": null
    }
  },
  "checks": [
    {
      "code": "mrz_checksums",
      "passed": true,
      "message": "Los dígitos de control de la MRZ son correctos."
    },
    {
      "code": "mrz_matches_visual",
      "passed": true,
      "message": "La MRZ coincide con los datos impresos."
    },
    {
      "code": "id_number",
      "passed": true,
      "message": "id_number"
    }
  ],
  "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