Public Finance Service API (SFiP)API Service Finances Publiques (SFiP)

API Service Finances Publiques (SFiP)Public Finance Service API (SFiP)

APIDiscovered1/7blocked by verifiedPreviewSubscribe🇫🇷France

This API from the French public finance administration provides access to public finance and taxation-related services at the national level. As of 30 September 2025, it incorporates the individual (natural person) search functionality previously offered by the R2P API, meaning new requests for that service are now handled through SFiP. Access conditions and prerequisites remain unchanged from those previously required for R2P. The service is intended for organizations needing to query public finance data tied to individuals within the French administrative system.### ATTENTION : **A partir du 30/09/2025, l'API SFiP reprend les fonctionnalités de recherche de personne physique de l'API R2P.** \ \ **Dorénavant, les nouvelles demandes concernant l'API R2P seront accessibles via l'API SFiP. Les modalités d'accès et les pré-requis restent inchangés pour accéder…

public-financetaxation

Read the docs

Trust score

How is this computed?

good

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

Data schema (72 fields)

Filterable via the API (19)

nomprenomsexenaisDatenaisCodePaysnaisCodeDeptnaisCodeCommuneadrCodePaysadrCodeDeptadrCodeCommuneadrCodeVoieadrLibelleVoieadrNumVoieadrIndiceRepetitionspiannrevdepartementbaremeveuvage

Field	Type	Description
nom	string	Birth surname of the searched person, max 100 characters.Nom de naissance de la personne recherchée, 100 car. Max.
prenom	string	Birth first name of the searched person, max 20 characters per name.Prénom de naissance de la personne recherchée, 20 car. Max. par prénom
sexe	string	Sex code: 1 for male, 2 for female.Valeur possible : 1 = masculin ou 2 = féminin. Format : 1 caractère numérique
naisDateNais date	string	Date of birth, accepted as YYYY, MM/YYYY, or DD/MM/YYYY.Date de naissance, trois formats différents acceptés : AAAA, MM/AAAA, ou JJ/MM/AAAA
naisCodePaysNais code pays	string	INSEE country code of birth, 5 numeric characters.Code du pays sur 5 caractères numériques (cf nomenclature INSEE)
naisCodeDeptNais code dept	string	Department or overseas territory code at time of birth.Code du département à la date de naissance ou TOM. Format : 2 caractères (métropole) 3 caractères (TOM et DOM)
naisCodeCommuneNais code commune	string	INSEE commune code of birth.Code commune, 3 caractères numériques (métropole), 2 caractères numériques (TOM et DOM) (cf nomenclature INSEE)
adrCodePaysAdr code pays	string	INSEE country code of the address, 5 numeric characters.Code du pays sur 5 caractères numériques (cf nomenclature INSEE)
adrCodeDeptAdr code dept	string	Department or overseas territory code of the address.Code du département ou TOM . Format : 2 caractères alphanumérique (métropole) 3 caractères alphanumérique (TOM et DOM)
adrCodeCommuneAdr code commune	string	INSEE commune code of the address; requires a department to be set.Code commune, 3 caractères numériques (métropole). Ce code commune correspond au 3 derniers caractères du code INSEE de la commune. 2 caractères numériques (TOM et DOM) (cf nomenclature INSEE) . Cette zone ne peut être valorisée que si un département Métropole ou DOM est précisé
adrCodeVoieAdr code voie	string	Street code of the address, 4 alphanumeric characters.4 caractères alphanumériques
adrLibelleVoieAdr libelle voie	string	Street name of the address, up to 38 alphanumeric characters.38 caractères alphanumériques. Cette zone ne peut être valorisée que si que si un département Métropole ou DOM et une commune sont précisés.
adrNumVoieAdr num voie	string	Street number of the address.Numéro de l’adresse
adrIndiceRepetitionAdr indice repetition	string	Repetition index of the address (B=bis, T=ter, Q=quater).Indice de répétition de l’adresse (B = bis, T = ter, Q = quater)
spi	string	13-digit SPI tax identification number.Numéro fiscal SPI sur 13 caractères (chiffres uniquement)
annrev	string	Income year.Année de revenus
departement	string	Department or overseas territory code.Code du département ou TOM. Format: 2 caractères alphanumériques suivis de 0 (métropole): 130, 750... 3 caractères alphanumériques (TOM et DOM)
bareme	string	Tax scale reference year.Année de barême
veuvage	string	Indicates widowhood status affecting the number of returned tax declarations.En présence d'une situation de veuvage de l'usager veuvage = true : restitution d'une seule déclaration (celle du survivant), si veuvage = false : restitution de deux déclarations
erreur	object	Error details object returned by the API.Error details object returned by the API.
codeerreur	integer (int32)	Numeric error code.Code de l'erreur
messageerreur	string	Descriptive error message.Message de description de l'erreur
horodatageerreur	string	Timestamp of the error.Horodatage de l'erreur
descriptifInformation	string	Status message indicating the API is operational.L'API est opérationnelle
personnePhysiquePersonneReponseEnveloppe	object	Object containing data about the searched natural person.Object containing data about the searched natural person.
cdPaysAdresseReponse	string	INSEE country code of the address.Code INSEE du pays de l'adresse
lbPaysAdresseReponse	string	Country name of the address.Libellé du pays de l'adresse
cdDepartementAdresseReponse	string	INSEE department code of the address.Code INSEE du département de l'adresse
lbDepartementAdresseReponse	string	Department name of the address.Libellé du département de l'adresse
cdTOMAdresseReponse	string	INSEE code of the overseas territory of the address.Code INSEE du TOM de l'adresse
lbTOMAdresseReponse	string	Name of the overseas territory of the address.Libellé du TOM de l'adresse
cdCommuneAdresseReponse	string	INSEE commune code of the address.Code INSEE de la commune de l'adresse
lbCommuneAdresseReponse	string	Commune name of the address.Libellé de la commune de l'adresse
cdVoieAdresseReponse	string	Street code of the address.Code de la de la voie de l'adresse
lbVoieAdresseReponse	string	Street name of the address.Libellé de la voie de l'adresse
numeroVoieAdresseReponse	string	Street number of the address.Numéro de la voie de l'adresse
indiceDeRepetitionAdresseReponse	string	Repetition index of the address (B=bis, T=ter, Q=quater).Indice de répétion de l'adresse (B = bis, T = ter, Q = quater)
complementAdresseAdresseReponse	string	Additional address information.Complément d'adresse
cdSexeEtatCivilReponse	string	Sex code of the person: 1 male, 2 female.Code du sexe de la personne : 1 masculin, 2 féminin
lbNomNaissanceEtatCivilReponse	string	Birth surname of the person.nom de naissance
lbPrenomNaissanceEtatCivilReponse	string	Birth first name of the person.Prénom de naissance
lbNomUsageEtatCivilReponse	string	Usual (used) surname of the person.Nom d'usage
lbPrenomUsageEtatCivilReponse	string	Usual (used) first name of the person.Prénom d'usage
anneeNaissanceEtatCivilReponse	string	Year of birth in YYYY format.Année de naissance au format AAAA
moisNaissanceEtatCivilReponse	string	Month of birth in MM format.Mois de naissance au format MM
jourNaissanceEtatCivilReponse	string	Day of birth in DD format.Jour de naissance au format JJ
cdPaysNaissanceEtatCivilReponse	string	INSEE country code of birth.Code INSEE du pays de naissance
cdDeptNaissanceEtatCivilReponse	string	INSEE department code of birth.Code INSEE du département de naissance
cdTOMNaissanceEtatCivilReponse	string	INSEE overseas territory code of birth.Code INSEE du TOM de naissance
cdCommuneNaissanceEtatCivilReponse	string	INSEE commune code of birth.cdCommuneNaissance
lieuNaissanceEtatCivilReponse	object	Object describing the place of birth.Object describing the place of birth.
telFixeCoordonneesReponse	string	Landline telephone number.Numéro de téléphone fixe
telPortableCoordonneesReponse	string	Mobile telephone number.Numéro de téléphone portable
courrielCoordonneesReponse	string	Email address.Adresse électronique
cdCommuneAJourLieuValeur	string	Current INSEE commune code for the location.Current INSEE commune code for the location.
cdDeptLieuValeur	string	Department code for the location.Department code for the location.
cdDeptAJourLieuValeur	string	Current department code for the location.Current department code for the location.
cdNatVoieLieuValeur	string	Nature code of the street for the location.Nature code of the street for the location.
cdPaysAJourLieuValeur	string	Current INSEE country code for the location.Current INSEE country code for the location.
cdRegLieuValeur	string	Region code for the location.Region code for the location.
cdRegAJourLieuValeur	string	Current region code for the location.Current region code for the location.
cdVoieAJourLieuValeur	string	Current street code for the location.Current street code for the location.
indRepLieuValeur	string	Repetition index of the location address (B=bis, T=ter, Q=quater).Repetition index of the location address (B=bis, T=ter, Q=quater).
lbCompAdresLieuValeur	string	Additional address information for the location.Additional address information for the location.
lbDeptLieuValeur	string	Department name for the location.Department name for the location.
lbRegLieuValeur	string	Region name for the location.Region name for the location.
noVoieLieuValeur	string	Street number for the location.Street number for the location.
identifiantPersonneReponse	object	Object containing identifying information of the person.Object containing identifying information of the person.
etatCivilPersonneReponse	object	Object containing civil status information of the person.Object containing civil status information of the person.
adressePersonneReponse	object	Object containing address information of the person.Object containing address information of the person.
codePostalAdresseAvecCodePostalReponse	string	Postal code of the address.codePostal
coordonneesPersonneSansSpiCoordonneesReponse	object	Object containing contact details of the person.Object containing contact details of the person.

Schema captured from openapi 26 days ago.

Verification Status

Using the API

Configuration

Format: openapi

Query examples

curl -s 'https://raw.githubusercontent.com/betagouv/api_gouv_swaggers/refs/heads/main/swaggers/API-SFIP.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.