Skip to content
Constaia
eu_residence_permit

EU residence permit (uniform format)

Residence permit card for third-country nationals in the uniform format of Regulation (EC) 1030/2002 (TD1 MRZ), issued by any EU/EEA State or Switzerland.

Category
Residence
Country
European Union
Fields it extracts
15 fields
Cost
1 credit
eu_residence_permitspecimen
Document number
First name
Last name
Sex
Nationality
Date of birth
Issue date
Expiry date
Issuing country

What it checks

  • MRZ ICAO 9303. Check digits of the machine readable zone.
  • MRZ vs printed data. The MRZ matches the visible data.
  • Holder. Name, number or date of birth match what you expect.
  • Age. Minimum or maximum age from the date of birth.
  • Validity. Not expired on the reference date.

Fields it extracts

  • Document numberdocument_number
  • First namefirst_name
  • Last namelast_name
  • Sexsex
  • Nationalitynationality
  • Date of birthbirth_date
  • Issue dateissue_date
  • Expiry dateexpiry_date
  • Issuing countryissuing_country
  • Mrzmrz
  • Permit typepermit_type
  • Remarksremarks
  • Place of birthbirth_place
  • Addressaddress
  • Personal numberpersonal_number

Sample request

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

Sample response

Fictitious data. Shortened response.

200 OK · application/json
{
  "id": "an_01J9Z3K8QW4T6Y2B7N5M1R0PXC",
  "object": "analysis",
  "status": "completed",
  "livemode": false,
  "document": {
    "type": "eu_residence_permit",
    "label": "EU residence permit (uniform format)",
    "confidence": 0.97
  },
  "verdict": {
    "expected": [
      "eu_residence_permit"
    ],
    "match": true,
    "status": "valid",
    "reasons": [
      {
        "code": "type_match",
        "severity": "info",
        "message": "The document is: EU residence permit (uniform format)."
      }
    ]
  },
  "fields": {
    "document_number": {
      "value": "X01234567",
      "confidence": 0.99,
      "validated": true
    },
    "first_name": {
      "value": "AMINA",
      "confidence": 0.98,
      "validated": null
    },
    "last_name": {
      "value": "SPECIMEN",
      "confidence": 0.97,
      "validated": null
    },
    "sex": {
      "value": "F",
      "confidence": 0.96,
      "validated": null
    },
    "nationality": {
      "value": "SEN",
      "confidence": 0.99,
      "validated": null
    },
    "birth_date": {
      "value": "1990-02-11",
      "confidence": 0.98,
      "validated": null
    },
    "issue_date": {
      "value": "2024-05-20",
      "confidence": 0.97,
      "validated": null
    },
    "expiry_date": {
      "value": "2029-05-19",
      "confidence": 0.96,
      "validated": null
    },
    "issuing_country": {
      "value": "DEU",
      "confidence": 0.99,
      "validated": null
    },
    "mrz": {
      "value": "ARD<<X012345679<<<<<<<<<<<<<<<\n9002111F2905198SEN<<<<<<<<<<<8\nSPECIMEN<<AMINA<<<<<<<<<<<<<<<",
      "confidence": 0.98,
      "validated": null
    },
    "permit_type": {
      "value": "Aufenthaltserlaubnis",
      "confidence": 0.97,
      "validated": null
    }
  },
  "checks": [
    {
      "code": "mrz_checksums",
      "passed": true,
      "message": "The MRZ check digits are correct."
    },
    {
      "code": "mrz_matches_visual",
      "passed": true,
      "message": "The MRZ matches the printed data."
    }
  ],
  "warnings": [],
  "storage": {
    "mode": "none",
    "file_deleted_at": "2026-09-29T10:00:02Z",
    "expires_at": null
  },
  "usage": {
    "credits": 1,
    "pages": 1
  }
}

FAQ

Does Constaia prove that the document is authentic?

No. It checks the type, the consistency of the data and your rules, and flags signals such as a possible edit or a photo of a screen. That does not prove authenticity.

Is a copy of the document kept?

Only if it needs review: it is then kept encrypted until someone decides and for 24 hours after that (configurable). Otherwise it is deleted as soon as the analysis ends. You can choose never to keep it.

Other documents

And for the record…

Create your free account and validate your first document in five minutes. No card required.