es_aeat_census_certificate

Spanish tax census status certificate (AEAT)

Spanish Tax Agency certificate showing tax address, business activity codes (IAE), tax regimes and periodic obligations; signed PDF with CSV.

Category: Tax
Country: Spain
Extracted fields: 9 fields
Cost: 1 credit

es_aeat_census_certificatespecimen

Holder name
Holder ID number
Issue date
Tax address
Activities
Vat regime
Income tax regime
Registration 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.
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.

Extracted fields

Holder nameholder_name
Holder ID numberholder_id
Issue dateissue_date
Tax addresstax_address
Activitiesactivities
Vat regimevat_regime
Income tax regimeincome_tax_regime
Registration dateregistration_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_census_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_census_certificate",
    "label": "Spanish tax census status certificate (AEAT)",
    "confidence": 0.97
  },
  "verdict": {
    "expected": [
      "es_aeat_census_certificate"
    ],
    "match": true,
    "status": "valid",
    "reasons": [
      {
        "code": "type_match",
        "severity": "info",
        "message": "The document is: Spanish tax census status 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_address": {
      "value": "C/ MAYOR 1, 28013 MADRID",
      "confidence": 0.96,
      "validated": null
    },
    "activities": {
      "value": [
        "763 - Programadores y analistas de informática"
      ],
      "confidence": 0.99,
      "validated": null
    },
    "vat_regime": {
      "value": "General",
      "confidence": 0.98,
      "validated": null
    },
    "income_tax_regime": {
      "value": "Estimación directa simplificada",
      "confidence": 0.97,
      "validated": null
    },
    "registration_date": {
      "value": "2020-01-01",
      "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 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