Skip to content
Constaia
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
Fields it extracts
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.

Fields it extracts

  • 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 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.