Skip to content
Constaia
es_disability_certificate

Spanish disability certificate

Degree, holder and validity of the disability certificate.

Category
Certificates
Country
Spain
Fields it extracts
6 fields
Cost
1 credit
es_disability_certificatespecimen
Holder name
Holder ID number
Disability degree (%)
Issue date
Valid until
Issuer

For reduced fees, adapted categories or grants. Constaia extracts the degree and the validity and checks the holder. This is health data: it extracts only what is essential.

What it checks

  • NIF/NIE check letter. The check character is recomputed (mod 23).
  • Validity. Not expired on the reference date.
  • Holder. Name, number or date of birth match what you expect.

Fields it extracts

  • Holder nameholder_name
  • Holder ID numberholder_id
  • Disability degree (%)degree_percent
  • Issue dateissue_date
  • Valid untilvalid_until
  • Issuerissuer

Where it is used

Sample request

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

Sample response

Fictitious data. Shortened response.

200 OK · application/json
{
  "id": "an_01J9Z3K8QW4T6Y2B7N5M1R0PXC",
  "object": "analysis",
  "status": "completed",
  "livemode": false,
  "document": {
    "type": "es_disability_certificate",
    "label": "Spanish disability certificate",
    "confidence": 0.97
  },
  "verdict": {
    "expected": [
      "es_disability_certificate"
    ],
    "match": true,
    "status": "valid",
    "reasons": [
      {
        "code": "type_match",
        "severity": "info",
        "message": "The document is: Spanish disability 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
    },
    "degree_percent": {
      "value": 33,
      "confidence": 0.97,
      "validated": null
    },
    "issue_date": {
      "value": "2024-02-10",
      "confidence": 0.96,
      "validated": null
    },
    "valid_until": {
      "value": null,
      "confidence": 0.99,
      "validated": null
    },
    "issuer": {
      "value": "Comunidad Autónoma",
      "confidence": 0.98,
      "validated": null
    }
  },
  "checks": [
    {
      "code": "nif_check_digit",
      "passed": true,
      "message": "The NIF check letter is correct."
    },
    {
      "code": "holder_match",
      "passed": true,
      "message": "The holder matches."
    }
  ],
  "warnings": [],
  "storage": {
    "mode": "none",
    "file_deleted_at": "2026-09-29T10:00:02Z",
    "expires_at": null
  },
  "usage": {
    "credits": 1,
    "pages": 2
  }
}

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.