Personal Income Tax APIAPI Impôt particulier

Name: Personal Income Tax API
Creator: data.gouv.fr

API Impôt particulierPersonal Income Tax API

APIDiscovered1/7blocked by verifiedPreviewSubscribe🇫🇷France

This API, published by the French tax authority (DGFiP) via the data.gouv.fr platform, enables secure exchange of personal tax information between the DGFiP and authorized third parties, such as government administrations, ministries, public bodies, local authorities, or businesses, in the context of their online services (téléservices). It is designed to simplify administrative procedures for citizens by allowing eligible organizations to verify or retrieve individual tax data directly, reducing the need for users to submit paper documents. Access is granted under agreements with the DGFiP, supporting streamlined, dematerialized administrative and business processes involving personal taxation in France.L'API Impôt particulier simplifie les démarches des usagers et le processus de gestion de vos téléservices. Elle permet l’échange d’informations fiscales entre la DGFiP et une entité administrative (administration, ministère, organisme public, collectivité) ou une entreprise dans le cadre de leurs…

educationbusinesstaxationgovernment

Read the docs Visit homepage

Trust score

How is this computed?

good

Weighted across five axes. Tap a ring for what it measures.

Data schema (91 fields)

Filterable via the API (4)

spiannrevdepartementbareme

Field	Type	Description
spi	string	Taxpayer's fiscal identification number.Numéro fiscal
annrev	integer (int32)	Income year the tax data refers to.Année de revenus
departement	string	Department number of the taxpayer's location.Numéro de département
bareme	string	Tax scale reference year.Année barème
complementAdresseAftJAXBbean	string	Additional address information line.Additional address information line.
voieAftJAXBbean	string	Street name and number of the address.Street name and number of the address.
getcommuneAftJAXBbean	string	Name of the municipality.Name of the municipality.
getcodePostalAftJAXBbean	string	Postal code of the address.Postal code of the address.
codeCodeRevJAXBbean	string	Income code identifier.Income code identifier.
valeurCodeRevJAXBbean	string	Value associated with the income code.Value associated with the income code.
jourDateNaisDecJAXBbean	string	Day of the declarant's birth date.Day of the declarant's birth date.
moisDateNaisDecJAXBbean	string	Month of the declarant's birth date.Month of the declarant's birth date.
anneeDateNaisDecJAXBbean	string	Year of the declarant's birth date.Year of the declarant's birth date.
nbPacPacJAXBbean	integer (int32)	Number of dependants.Number of dependants.
nbPacFPacJAXBbean	integer (int32)	Number of dependants under category F.Number of dependants under category F.
nbPacGPacJAXBbean	integer (int32)	Number of dependants under category G.Number of dependants under category G.
nbPacHPacJAXBbean	integer (int32)	Number of dependants under category H.Number of dependants under category H.
nbPacIPacJAXBbean	integer (int32)	Number of dependants under category I.Number of dependants under category I.
nbPacRPacJAXBbean	integer (int32)	Number of dependants under category R.Number of dependants under category R.
nbPacJPacJAXBbean	integer (int32)	Number of dependants under category J.Number of dependants under category J.
nbPacNPacJAXBbean	integer (int32)	Number of dependants under category N.Number of dependants under category N.
nbPacPPacJAXBbean	integer (int32)	Number of dependants under category P.Number of dependants under category P.
tsprRevsJAXBbean	array<object>	List of salaries, wages and pension income items.List of salaries, wages and pension income items.
rcmRevsJAXBbean	array<object>	List of investment income (capital revenue) items.List of investment income (capital revenue) items.
pvRevsJAXBbean	array<object>	List of capital gains income items.List of capital gains income items.
foncRevsJAXBbean	array<object>	List of property (rental) income items.List of property (rental) income items.
proRevsJAXBbean	array<object>	List of professional/business income items.List of professional/business income items.
chgesRevsJAXBbean	array<object>	List of deductible expenses items.List of deductible expenses items.
riciRevsJAXBbean	array<object>	List of tax credits and reductions items.List of tax credits and reductions items.
alphaRevsJAXBbean	array<object>	List of miscellaneous alphanumeric income items.List of miscellaneous alphanumeric income items.
divRevsJAXBbean	array<object>	List of other/miscellaneous income items.List of other/miscellaneous income items.
sitPartPSitPartJAXBbean	string	Marital/family situation indicator P.Marital/family situation indicator P.
sitPartFSitPartJAXBbean	string	Marital/family situation indicator F.Marital/family situation indicator F.
sitPartWSitPartJAXBbean	string	Marital/family situation indicator W.Marital/family situation indicator W.
sitCombSitPartJAXBbean	string	Combined marital/family situation code.Combined marital/family situation code.
pensVeufGuerreSitPartJAXBbean	string	Indicator for war widow's pension.Indicator for war widow's pension.
indEnfSeul5ansMinSitPartJAXBbean	string	Indicator for single parent with child under 5.Indicator for single parent with child under 5.
indNonSeulSitPartJAXBbean	string	Indicator that the taxpayer is not living alone.Indicator that the taxpayer is not living alone.
annRevenuSituationsIRAssiettesMillesimeJAXBbean	integer (int32)	Income year the tax assessment covers.Income year the tax assessment covers.
rfrSituationsIRAssiettesMillesimeJAXBbean	integer (int64)	Reference tax income amount (revenu fiscal de référence).Reference tax income amount (revenu fiscal de référence).
sitFamSituationsIRAssiettesMillesimeJAXBbean	string	Family situation code (married, single, etc.).Family situation code (married, single, etc.).
nbPartSituationsIRAssiettesMillesimeJAXBbean	number (double)	Number of tax household parts (quotient familial).Number of tax household parts (quotient familial).
pacSituationsIRAssiettesMillesimeJAXBbean	object	Dependants information object.Dependants information object.
nmNaiDec1SituationsIRAssiettesMillesimeJAXBbean	string	Birth name of first declarant.Birth name of first declarant.
nmUsaDec1SituationsIRAssiettesMillesimeJAXBbean	string	Usual (family) name of first declarant.Usual (family) name of first declarant.
prnmDec1SituationsIRAssiettesMillesimeJAXBbean	string	First name of first declarant.First name of first declarant.
dateNaisDec1SituationsIRAssiettesMillesimeJAXBbean	object	Birth date of first declarant.Birth date of first declarant.
dptNaissDec1SituationsIRAssiettesMillesimeJAXBbean	string	Department of birth of first declarant.Department of birth of first declarant.
lieuNaissDec1SituationsIRAssiettesMillesimeJAXBbean	string	Place of birth of first declarant.Place of birth of first declarant.
nmNaiDec2SituationsIRAssiettesMillesimeJAXBbean	string	Birth name of second declarant.Birth name of second declarant.
nmUsaDec2SituationsIRAssiettesMillesimeJAXBbean	string	Usual (family) name of second declarant.Usual (family) name of second declarant.
prnmDec2SituationsIRAssiettesMillesimeJAXBbean	string	First name of second declarant.First name of second declarant.
dateNaisDec2SituationsIRAssiettesMillesimeJAXBbean	object	Birth date of second declarant.Birth date of second declarant.
dptNaissDec2SituationsIRAssiettesMillesimeJAXBbean	string	Department of birth of second declarant.Department of birth of second declarant.
lieuNaissDec2SituationsIRAssiettesMillesimeJAXBbean	string	Place of birth of second declarant.Place of birth of second declarant.
aftSituationsIRAssiettesMillesimeJAXBbean	string	Tax affiliation status code.Tax affiliation status code.
aftDetailSituationsIRAssiettesMillesimeJAXBbean	object	Detailed tax affiliation status information.Detailed tax affiliation status information.
sitParIsoSituationsIRAssiettesMillesimeJAXBbean	string	Isolated/separated household situation indicator.Isolated/separated household situation indicator.
pensAlPerSituationsIRAssiettesMillesimeJAXBbean	integer (int32)	Alimony payments received or paid amount.Alimony payments received or paid amount.
indDeficitSituationsIRAssiettesMillesimeJAXBbean	string	Indicator of a reported tax deficit.Indicator of a reported tax deficit.
revenuBrutGlobalSituationsIRAssiettesMillesimeJAXBbean	integer (int64)	Total gross income of the tax household.Total gross income of the tax household.
sitPartSituationsIRAssiettesMillesimeJAXBbean	string	Household marital/family situation code.Household marital/family situation code.
sitParDeclareeSituationsIRAssiettesMillesimeJAXBbean	object	Declared marital/family situation details.Declared marital/family situation details.
indOptionImpotSeparSituationsIRAssiettesMillesimeJAXBbean	string	Indicator for separate taxation option.Indicator for separate taxation option.
mntRevbaremeSituationsIRAssiettesMillesimeJAXBbean	integer (int64)	Income amount subject to the progressive tax scale.Income amount subject to the progressive tax scale.
datRecSituationsIRAssiettesMillesimeJAXBbean	string	Date the tax assessment was received.Date the tax assessment was received.
datEtabSituationsIRAssiettesMillesimeJAXBbean	string	Date the tax assessment was established.Date the tax assessment was established.
impAvImputSituationsIRAssiettesMillesimeJAXBbean	integer (int64)	Tax amount before credits/imputations applied.Tax amount before credits/imputations applied.
montTotIrSituationsIRAssiettesMillesimeJAXBbean	integer (int64)	Total income tax amount due.Total income tax amount due.
revImposableSituationsIRAssiettesMillesimeJAXBbean	integer (int64)	Taxable income amount.Taxable income amount.
numRoleSituationsIRAssiettesMillesimeJAXBbean	string	Tax assessment roll number.Tax assessment roll number.
fipNumSituationsIRAssiettesMillesimeJAXBbean	string	Taxpayer's individual fiscal identification number.Taxpayer's individual fiscal identification number.
revSituationsIRAssiettesMillesimeJAXBbean	object	Income details object.Income details object.
statutOuvertureLepJAXBbean	string	Status of the account opening (LEP).Status of the account opening (LEP).
spiDec1SituationIRAssietteMultiJAXBbean	string	Fiscal identification number of first declarant.Fiscal identification number of first declarant.
spiDec2SituationIRAssietteMultiJAXBbean	string	Fiscal identification number of second declarant.Fiscal identification number of second declarant.
dateDebutPeriodeSituationIRAssietteMultiJAXBbean	string	Start date of the period covered.Start date of the period covered.
dateFinPeriodeSituationIRAssietteMultiJAXBbean	string	End date of the period covered.End date of the period covered.
typeAvisSituationIRAssietteMultiJAXBbean	integer (int32)	Type code of the tax notice.Type code of the tax notice.
dateDecesdec1SituationIRAssietteMultiJAXBbean	string	Date of death of first declarant, if applicable.Date of death of first declarant, if applicable.
dateDecesdec2SituationIRAssietteMultiJAXBbean	string	Date of death of second declarant, if applicable.Date of death of second declarant, if applicable.
situationsIRSituationsIRAssiettesMultipleJAXBbean	array<object>	List of income tax situations across years.List of income tax situations across years.
numLigneSituationIRfactureJAXBbean	integer (int32)	Line number in the tax notice detail.Line number in the tax notice detail.
codeLigneSituationIRfactureJAXBbean	string	Code identifying the tax notice line.Code identifying the tax notice line.
libelleLigneSituationIRfactureJAXBbean	string	Label describing the tax notice line.Label describing the tax notice line.
colonne1SituationIRfactureJAXBbean	string	Value of the first column on the line.Value of the first column on the line.
colonne2SituationIRfactureJAXBbean	string	Value of the second column on the line.Value of the second column on the line.
colonne3SituationIRfactureJAXBbean	string	Value of the third column on the line.Value of the third column on the line.
colonne4SituationIRfactureJAXBbean	string	Value of the fourth column on the line.Value of the fourth column on the line.
factureSituationsIRAssiettesFacturesJAXBbean	array<object>	List of tax notice detail lines.List of tax notice detail lines.
indicateurIfiIsfSituationIfiIsfJAXBbean	string	Indicator for wealth tax (IFI/ISF) liability.Indicator for wealth tax (IFI/ISF) liability.

Schema captured from openapi 1 month ago.

Verification Status

Using the API

Configuration

Format: openapi

Query examples

curl -s 'https://raw.githubusercontent.com/betagouv/api_gouv_swaggers/main/swaggers/api-impot-particulier.json' -H 'Accept: application/json'

Machine-readable API description (use it to generate clients).

Full API documentation ↗

Machine-readable & source

OpenAPI spec JSON

Embed this badge in a README or wiki — it always shows the latest verification state and quality tier.