es_aeat_income_certificateSpanish income tax certificate (AEAT)
Spanish Tax Agency personal income tax certificate (return summary, or reported income if no return was filed); signed PDF with CSV.
- Category
- Tax
- Country
- Spain
- Fields it extracts
- 9 fields
- Cost
- 1 credit
es_aeat_income_certificatespecimen- Holder name
- Holder ID number
- Issue date
- Tax year
- Has filed
- General tax base
- Savings tax base
- Total income
- 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.
- Recency. Issued less than N days ago.
- 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 - Issue date
issue_date - Tax year
tax_year - Has filed
has_filed - General tax base
general_tax_base - Savings tax base
savings_tax_base - Total income
total_income - 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_income_certificate",
"checks": {
"max_age_days": 90,
"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_income_certificate",
"label": "Spanish income tax certificate (AEAT)",
"confidence": 0.97
},
"verdict": {
"expected": [
"es_aeat_income_certificate"
],
"match": true,
"status": "valid",
"reasons": [
{
"code": "type_match",
"severity": "info",
"message": "The document is: Spanish income tax certificate (AEAT)."
}
]
},
"fields": {
"holder_name": {
"value": "JUAN ESPAÑOL ESPAÑOL",
"confidence": 0.99,
"validated": true
},
"holder_id": {
"value": "99999999R",
"confidence": 0.98,
"validated": null
},
"issue_date": {
"value": "2026-09-01",
"confidence": 0.97,
"validated": null
},
"tax_year": {
"value": 2025,
"confidence": 0.96,
"validated": null
},
"has_filed": {
"value": true,
"confidence": 0.99,
"validated": null
},
"general_tax_base": {
"value": 28500,
"confidence": 0.98,
"validated": null
},
"savings_tax_base": {
"value": 350.2,
"confidence": 0.97,
"validated": null
},
"csv_code": {
"value": "ABCDEFGH12345678",
"confidence": 0.96,
"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: 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
- Spanish tax compliance certificate (AEAT)
- Spanish Social Security compliance certificate
- Spanish tax census status certificate (AEAT)
- Spanish tax identification card (NIF)
- Spanish personal income tax return (form 100)
- 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 card required.