Skip to content
Constaia

Is this documenta valid ID card?

Constaia answers yes, no or review, with the reasons and the data on the document. Without keeping copies, except those that need review.

POST /v1/analyzeexpect="es_dni"
Fictitious specimen ID card analysed by Constaia: fields located and a valid verdict.
Valid
  • It is a Spanish ID card
  • The ID number check letter is correct
  • The machine readable zone matches the front
  • Valid until 2031
Fictitious specimen ID card analysed by Constaia: fields located and a valid verdict.

Born at Add On Sport, the registration and licensing software used by Spanish sports federations. We validate those documents every season.

Try it with a document

Pick a fictitious sample or upload your own document and see the result in seconds. The full demo also shows the technical response and the code.

Sample documents

Spanish ID (specimen)

The demo does not keep the document: it is deleted as soon as the analysis ends.

Preview of Spanish ID (specimen)

Click “Analyse document” to see the verdict, the reasons and the extracted data.

See the full demo

Three possible answers. Always with reasons.

Your system does not have to interpret any text: it gets a clear answer and the list of reasons in your language.

  1. Valid

    The document is what you expected

    It is the right type and meets all your rules: in date, in the person's name and as recent as you require.

    Right type · In date · Right holder
  2. Invalid

    It will not do, and you know why

    It is a different document or an important rule fails: expired, belonging to someone else, with a wrong ID number check letter or with totals that do not add up.

    Different document · Wrong check letter · Totals do not add up
  3. Review

    A person should look at it

    Confidence is low, the photo is poor or there are doubtful signals, such as a photo of a screen. It lands in your team's review inbox.

    Low confidence · Blurry photo · Possible photo of a screen

From a single document to the whole process

Request documents with a link, group them by person, decide the doubtful cases as a team and comply with data protection rules effortlessly.

What we check, without guessing

AI reads and classifies. Then fixed rules check everything that can be calculated: check digits, dates and totals.

Machine readable zone (ICAO 9303)

We read the machine readable zone of ID cards and passports, recalculate its check digits and compare it with the printed data.

IDESPZZX123456899999999R<<<<<<
9003141F3106028ESP<<<<<<<<<<<5
ESPECIMEN<RUIZ<<CARMEN<<<<<<<<

Spanish NIF, NIE and CIF check letter

With the official algorithm, not an estimate.

99999999 mod 23 = 1 → R

IBAN

Check digits and each country's length on receipts and bank certificates.

ES91 2100 0418 4502 0005 1332 mod 97 = 1

Expiry and age of the document

Valid today or on the date you choose, and issued within the number of days you require.

expiry_date 2031-06-02 > 2026-09-29

Holder

Flexible matching: accents ignored, surnames in any order and typos tolerated.

“Carmen Especimen Ruiz” ≈ ESPECIMEN RUIZ, CARMEN

Invoice totals

Net amount, VAT and total have to add up. If they do not, the document is marked as invalid.

2.050,00 + 21 % = 2.480,50 ≠ 2.490,50

Verify without keeping a copy

Under the GDPR you should only keep the data you actually need, and keeping copies of ID documents rarely passes that test. With Constaia you check the document and, if there is nothing to review, the file is gone when the analysis ends.

Only what needs review is kept
By default, the file is deleted when the analysis ends. It is only kept, encrypted, if it needs review, and deleted once a decision is made. If you prefer, it is never kept.
Hosted in the EU
Our servers are in Spain and anything you choose to keep is hosted in the EU. AI analysis is carried out by Cloudflare Workers AI, which does not keep the documents or train on them. If you need everything to happen in the EU, turn on the sovereign profile.
Minimum data
From a medical certificate we extract whether the person is fit, the date and the doctor. Never diagnoses.
Data processor
A data processing agreement (DPA) with the list of subprocessors. Files are encrypted with a different key for each account.
  1. 10:00:00.000Document received and encrypted
  2. 10:00:02.084Verdict and fields returned
  3. 10:00:02.091File deleted
  4. "storage": { "mode": "review", "kept": false, "file_deleted_at": "2026-09-29T10:00:02Z" }

What we do not do: Constaia does not certify that a document is authentic. A correct check letter or machine readable zone does not prove it. Warnings are signals for you to decide on. Biometrics only if you turn them on (EU, with explicit consent and no images stored).

Integrate it in an afternoon

A simple API with libraries for JavaScript, PHP and Python, a free test mode and examples for your framework.

5-minute quickstartOr add it to your website only, with the widget
curl https://api.constaia.com/v1/analyze \
  -H "Authorization: Bearer $CONSTAIA_API_KEY" \
  -F "file=@dni_especimen.png" \
  -F 'options={
    "expect": "es_dni",
    "checks": {
      "not_expired": true,
      "holder": {
        "full_name": "Carmen Especimen Ruiz"
      }
    },
    "storage": "none"
  }'

Built for people who receive documents every day

We were born in sport, where paperwork is mandatory, recurring and expires. It works just as well for HR, rentals, accounting firms and insurers.

See all

Frequently asked questions

Does Constaia verify that an ID card is authentic?

No. We check that the document is the expected type, that its data is consistent (check letter, check digits, dates) and that it meets your rules. That does not prove it is authentic: fake documents with consistent data exist. We give you signals, such as a possible photo of a screen or a possible edit. If you need to check that the person sending the document is its holder, you can turn on the optional face verification: a selfie with a liveness check compared with the document photo, EU only, with explicit consent and no images stored.

Do you keep the documents?

By default, only those that need human review: they are kept encrypted in the EU until someone decides and deleted 24 hours later (configurable), or after 30 days if nobody decides. All others are deleted as soon as the analysis ends. You can also choose never to keep the file, to keep it for a few hours, until you delete it, or only as an anonymised copy, and even not to keep the extracted data.

Where is the data processed?

Our servers are in Spain (IONOS) and the data you choose to keep is hosted in the EU. By default, AI analysis is carried out by Cloudflare Workers AI on its network, without keeping the documents or training on them. If you need the analysis to be done entirely with European providers, you can turn on the sovereign profile. The full list of subprocessors is in the DPA.

How much does it cost?

One credit per document of up to two pages (an ID card, front and back, counts as one). You get 150 free credits a month, plans from €29 a month with 1,000 credits, and top-ups from €10. We do not charge for analyses that fail on our side or for documents rejected because of poor quality.

Can I try it without paying?

Yes. Test mode is free and unlimited so you can integrate at your own pace, and this page has a demo with 5 real analyses a day. On top of that, the free plan includes 150 real documents every month.

What happens when the result is “review”?

It means there are doubts: low confidence in the reading or unusual signals. The document goes to your team's review inbox, where someone approves or rejects it with one click, and your system is notified.

Can I request documents without writing any code?

Yes. With verification links you send a link or a QR code, the person uploads their documents from their phone and you see the result in the dashboard.

Does it work for Spanish sex offence record certificates (LOPIVI)?

Yes: we check the type, the holder, how recent it is and whether any records are listed, and we extract the secure verification code so you can check it on the Spanish Ministry of Justice website. We do not query that website automatically.

Who is behind Constaia?

Add On Dev Solutions S.L., the company behind Add On Sport, which builds registration and licensing software for sport in Spain. Constaia grew out of validating those documents every day.

And for the record…

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