es_census_certificate

Spanish census registration certificate

Municipality, holder and age of the census registration (empadronamiento) certificate.

Category: Civil records
Country: Spain
Extracted fields: 5 fields
Cost: 1 credit

es_census_certificatespecimen

Holder name
Holder ID number
Address
Municipality
Issue date

For resident prices, school admissions or local grants. Constaia checks the holder, the municipality and that the certificate is recent.

What it checks

NIF/NIE check letter. The check character is recomputed (mod 23).
Recency. Issued less than N days ago.
Holder. Name, number or date of birth match what you expect.

Extracted fields

Holder nameholder_name
Holder ID numberholder_id
Addressaddress
Municipalitymunicipality
Issue dateissue_date

Sample request

curl https://api.constaia.com/v1/analyze \
  -H "Authorization: Bearer $CONSTAIA_API_KEY" \
  -F "file=@document.pdf" \
  -F 'options={
    "expect": "es_census_certificate",
    "checks": {
      "max_age_days": 90
    },
    "storage": "none"
  }'

Sample response

Fictitious data. Shortened response.

200 OK · application/json

{
  "id": "an_01J9Z3K8QW4T6Y2B7N5M1R0PXC",
  "object": "analysis",
  "status": "completed",
  "livemode": false,
  "document": {
    "type": "es_census_certificate",
    "label": "Spanish census registration certificate",
    "confidence": 0.97
  },
  "verdict": {
    "expected": [
      "es_census_certificate"
    ],
    "match": true,
    "status": "valid",
    "reasons": [
      {
        "code": "type_match",
        "severity": "info",
        "message": "The document is: Spanish census registration certificate."
      }
    ]
  },
  "fields": {
    "holder_name": {
      "value": "MARÍA GARCÍA LÓPEZ",
      "confidence": 0.99,
      "validated": true
    },
    "holder_id": {
      "value": "12345678Z",
      "confidence": 0.98,
      "validated": null
    },
    "municipality": {
      "value": "Sevilla",
      "confidence": 0.97,
      "validated": null
    },
    "issue_date": {
      "value": "2026-09-01",
      "confidence": 0.96,
      "validated": null
    }
  },
  "checks": [
    {
      "code": "max_age_days",
      "passed": true,
      "message": "The issue date is within the limit."
    }
  ],
  "warnings": [],
  "storage": {
    "mode": "none",
    "file_deleted_at": "2026-09-29T10:00:02Z",
    "expires_at": null
  },
  "usage": {
    "credits": 1,
    "pages": 1
  }
}

FAQ

Does Constaia prove the document is authentic?

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

Is a copy of the document kept?

No, unless you ask for it. With storage "none" (the default) the file is deleted when the analysis ends.

And for the record…

Create your account, copy the test key and validate your first document in five minutes.

Create a free account Talk to sales