Skip to main content
Our NFC Verification process provides the highest level of security by reading and validating the cryptographic data stored in the chip of modern identity documents. This guide explains the structure and contents of an NFC verification report.

​
Report Structure

The NFC verification report is returned as a JSON object containing an nfc object with the following key sections:
  • NFC Status: Overall verification status
  • Chip Data: Personal and document information extracted directly from the chip
  • Authenticity: Results of cryptographic validation checks
  • Certificate Summary: Details about the document’s digital certificates
  • Verification Metadata: Additional verification details and timestamps

​
Core Response Fields

interface NFCVerificationResponse {
  nfc: {
    status: 'Approved' | 'Declined' | 'In Review' | 'Not Finished';
    portrait_image: string;
    signature_image: string;
    chip_data: {
      document_type: string;
      issuing_country: string;     // ISO 3166-1 alpha-3
      document_number: string;
      expiration_date: string;     // YYYY-MM-DD
      first_name: string;
      last_name: string;
      birth_date: string;          // YYYY-MM-DD
      gender: 'M' | 'F' | 'U';
      nationality: string;         // ISO 3166-1 alpha-3
      address: string;
      place_of_birth: string;
    };
    authenticity: {
      sod_integrity: boolean;
      dg_integrity: boolean;
    };
    certificate_summary: {
      issuer: string;
      subject: string;
      serial_number: string;
      not_valid_after: string;     // YYYY-MM-DD HH:MM:SS
      not_valid_before: string;    // YYYY-MM-DD HH:MM:SS
    };
    warnings: {
      risk: string;
      additional_data: string | null;
      log_type: 'information' | 'warning' | 'error';
      short_description: string;
      long_description: string;
    }[];
  }
}

​
Sample JSON Response

{
  "nfc": {
    "status": "In Review",
    "portrait_image": "https://example.com/portrait.jpg",
    "signature_image": "https://example.com/signature.jpg",
    "chip_data": {
      "document_type": "ID",
      "issuing_country": "ESP",
      "document_number": "123456789",
      "expiration_date": "2030-01-01",
      "first_name": "John",
      "last_name": "Smith",
      "birth_date": "1990-05-15",
      "gender": "M",
      "nationality": "ESP",
      "address": "CALLE MAYOR 123 4B, MADRID, MADRID",
      "place_of_birth": "MADRID, MADRID"
    },
    "authenticity": {
      "sod_integrity": true,
      "dg_integrity": true
    },
    "certificate_summary": {
      "issuer": "Common Name: CSCA SPAIN, Serial Number: 3, Organization: DIRECCION GENERAL DE LA POLICIA, Country: ES",
      "subject": "Common Name: DS n-eID SPAIN 2, Organizational Unit: PASSPORT, Organization: DIRECCION GENERAL DE LA POLICIA, Country: ES",
      "serial_number": "118120836164494130086420187336801405660",
      "not_valid_after": "2031-02-18 10:21:11",
      "not_valid_before": "2020-11-18 10:21:11"
    },
    "warnings": [
      {
        "risk": "DATA_INCONSISTENT",
        "additional_data": null,
        "log_type": "warning",
        "short_description": "OCR and NFC mrz code extracted are not the same",
        "long_description": "The Optical Character Recognition (OCR) data and the NFC chip data don't match, indicating potential document tampering or data inconsistency."
      }
    ],
  }
}
For more information about potential warnings during the NFC verification process, check our NFC Verification Warnings guide.

​
Security Note

The data extracted from NFC chips is highly secure and tamper-proof. The cryptographic validation ensures that the document is authentic and has been issued by a legitimate government authority. This provides a significantly higher level of security compared to traditional OCR-based verification methods. The certificate validation process ensures that the document has not been tampered with and that the issuing authority is legitimate.