es_aeat_tax_id_cardSpanish tax identification card (NIF)
Card certifying the tax identification number (NIF) of a legal entity (Spanish Tax Agency), in electronic format with CSV.
- Category
- Tax
- Country
- Spain
- Fields it extracts
- 5 fields
- Cost
- 1 credit
es_aeat_tax_id_cardspecimen- Holder name
- Holder ID number
- Tax address
- Issue date
- Secure Verification Code (CSV)
What it checks
- National identifiers. Official checksum or format of the number (NIF, CPF, CURP, RUT, SSN…).
es_nif - Holder. Name, number or date of birth match what you expect.
- Secure verification code. Format of the code used to check it with the issuer.
- PDF electronic signature. PAdES signature verified when the original PDF is sent.
Fields it extracts
- Holder name
holder_name - Holder ID number
holder_id - Tax address
tax_address - Issue date
issue_date - Secure Verification Code (CSV)
csv_code
Sample request
curl https://api.constaia.com/v1/analyze \
-H "Authorization: Bearer $CONSTAIA_API_KEY" \
-F "file=@document.pdf" \
-F 'options={
"expect": "es_aeat_tax_id_card",
"checks": {
"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": "es_aeat_tax_id_card",
"label": "Spanish tax identification card (NIF)",
"confidence": 0.97
},
"verdict": {
"expected": [
"es_aeat_tax_id_card"
],
"match": true,
"status": "valid",
"reasons": [
{
"code": "type_match",
"severity": "info",
"message": "The document is: Spanish tax identification card (NIF)."
}
]
},
"fields": {
"holder_name": {
"value": "ESPECIMEN S.L.",
"confidence": 0.99,
"validated": true
},
"holder_id": {
"value": "B12345674",
"confidence": 0.98,
"validated": null
},
"tax_address": {
"value": "C/ MAYOR 1, 28013 MADRID",
"confidence": 0.97,
"validated": null
},
"issue_date": {
"value": "2019-02-11",
"confidence": 0.96,
"validated": null
},
"csv_code": {
"value": "ABCDEFGH12345678",
"confidence": 0.99,
"validated": null
}
},
"checks": [
{
"code": "id_number",
"passed": true,
"message": "id_number"
},
{
"code": "csv_format",
"passed": true,
"message": "The verification code has a valid format."
}
],
"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: then it's kept encrypted until someone decides and for 24 hours after that (configurable). Otherwise it's deleted as soon as the analysis ends. You can choose never to keep it.
Other documents
- Spanish tax compliance certificate (AEAT)
- Spanish Social Security compliance certificate
- Spanish tax census status certificate (AEAT)
- Spanish personal income tax return (form 100)
- Spanish income tax certificate (AEAT)
- German tax ID notice (Steuer-IdNr)
- Mexican tax status certificate (constancia de situación fiscal)
- Argentine CUIL/CUIT certificate
And for the record…
Create your free account and validate your first document in five minutes. No credit card required.