Data models

Taxes

The person’s yearly income-tax situation, from the Spanish tax agency (AEAT)

View as Markdown

Where it lives: in the Spain Public Administration results, at data.tax.individual_yearly. APIs with dedicated per-product results endpoints return this model directly.

Each entry is the person’s income-tax picture for one year: declared income, deductions and the resulting liability. The official document it comes from travels as an attachment.

product"tax_information"Required
sub_family"tax_information:persons_yearly_fiscal_data"Required
fetch_datestringRequiredformat: "datetime"
Date this product was fetched
primary_taxpayerstringRequired
National identifier of the taxpayer
addressobjectRequired
Fiscal address for the exercise
address_referencestringRequired
Cadastral reference for the main home
country_codestringRequiredformat: "country"
Country code for the tax declaration
currencystringRequiredformat: "currency"
Currency for the tax declaration
tax_agencystringRequired
Tax agency for the tax declaration
fiscal_year_startdateRequired
Start date of the fiscal year
fiscal_year_enddateRequired
End date of the fiscal year
statusenumRequired
Status of the fiscal data
filing_categoryenumRequired
Category of the tax filing
Allowed values:
taxable_basemap from strings to strings or nullRequired
Total taxable base
total_tax_paidmap from strings to strings or nullRequired
Total tax paid or withheld
final_tax_resultmap from strings to strings or nullRequired
incomeobjectRequired
Detailed breakdown of income
deductionsobjectRequired
Detailed breakdown of deductions
liabilitiesobjectRequired
Detailed breakdown of liabilities
joint_taxpayerslist of stringsOptional
List of national identifiers for joint taxpayers
attachmentslist of objectsOptionalDefaults to []
List of attached supporting documents

The breakdown

Income, deductions and liability, each with its own detail:

employmentobjectRequired
Employment income details
capitalobjectRequired
Capital income details
capital_gainsobjectRequired
Capital gains and losses details
businessobjectRequired
Business activity income details
real_estateobjectRequired
donationslist of objectsRequired
List of donations
total_donationsobjectRequired
Total donations
personal_allowanceobjectRequired
family_allowanceobjectRequired
regional_deductionsobjectRequired
Total deductions applied at regional level
state_deductionsobjectRequired
Total deductions applied at state level
total_deductionsobjectRequired
Grand total of all deductions
real_estate_loanslist of objectsOptionalDefaults to []
List of real estate loans