Bank Accounts and Similar Records File (FICOBA) APIAPI Fichier des Comptes Bancaires et Assimilés (FICOBA)

API Fichier des Comptes Bancaires et Assimilés (FICOBA)Bank Accounts and Similar Records File (FICOBA) API

APIDiscovered1/7blocked by verifiedPreviewSubscribe🇫🇷France

This API provides access to FICOBA, the French national register of bank accounts and similar accounts held by individuals and organizations. It allows eligible public administrations (government departments, ministries, social security bodies) and authorized private-sector actors to retrieve and validate a user's bank account details. The service is intended to support identity and payment verification processes, helping integrate accurate banking coordinates into administrative or business procedures. Access is restricted to entities meeting eligibility criteria set by the French authorities.L'API FICOBA (*FI*chier des *CO*mptes *B*ancaires et *A*ssimilés) permet aux entités administratives (administrations publiques, ministères, organismes sociaux) et aux acteurs privés qui sont éligibles d’accéder aux coordonnées bancaires d'un usager afin de permettre d'intégrer et de valider ces do…

geospatialgovernment

Visit homepage

Trust score

How is this computed?

good

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

Data schema (76 fields)

Field	Type	Description
descriptifEtatSante	string	Description of the API's current operating status.L'API est opérationnelle
codeReponseErreur	string	Error code returned by the API.Error code returned by the API.
messageReponseErreur	string	Human-readable error message returned by the API.Human-readable error message returned by the API.
horodatageReponseErreur	string	Timestamp of the error response.Timestamp of the error response.
erreurResultatErreurApiSante	object	Details of the error returned by the API health check.Details of the error returned by the API health check.
libAdr1AdresseGuichet	string	First line of the bank branch's address.First line of the bank branch's address.
libAdr2AdresseGuichet	string	Second line of the bank branch's address.Second line of the bank branch's address.
libAdr3AdresseGuichet	string	Third line of the bank branch's address.Third line of the bank branch's address.
libAdr4AdresseGuichet	string	Fourth line of the bank branch's address.Fourth line of the bank branch's address.
codeCaracteristiqueCaracteristiqueCompte	integer (int32)	Numeric code identifying an account characteristic.Numeric code identifying an account characteristic.
libelleCaracteristiqueCaracteristiqueCompte	string	Textual label of the account characteristic.Textual label of the account characteristic.
ibanCompteCaracteristiques	string	International Bank Account Number of the account.International Bank Account Number of the account.
dateOuvertureCompteCaracteristiques	string	Date the account was opened.Date the account was opened.
dateFiscaleCompteCaracteristiques	string	Fiscal date associated with the account.Fiscal date associated with the account.
codeMotifOuvertureCompteCaracteristiques	string	Code identifying the reason the account was opened.Code identifying the reason the account was opened.
libelleMotifOuvertureCompteCaracteristiques	string	Textual label for the account opening reason.Textual label for the account opening reason.
dateClotureCompteCaracteristiques	string	Date the account was closed.Date the account was closed.
natureCompteCaracteristiques	object	Nature (category) of the bank account.Nature (category) of the bank account.
typeCompteCaracteristiques	object	Type of the bank account.Type of the bank account.
formatCompteCompteCaracteristiques	string	Format code of the account structure.Format code of the account structure.
caracteristiqueCompteCaracteristiques	object	Characteristic attributes of the account.Characteristic attributes of the account.
successionCompteCaracteristiques	string	Indicator relating to account succession status.Indicator relating to account succession status.
residentCompteCaracteristiques	string	Indicator of whether the account holder is a resident.Indicator of whether the account holder is a resident.
deviseCompteCaracteristiques	object	Currency of the account.Currency of the account.
caracteristiqueCompteCompteStructure	object	Set of characteristics describing the account.Set of characteristics describing the account.
etablissementGestionnaireCompteStructure	object	Bank establishment managing the account.Bank establishment managing the account.
ayantsDroitsCompteStructure	array<object>	List of persons entitled to the account.List of persons entitled to the account.
dateDemandeDemandeRestit	string	Date the request was made.Date the request was made.
motifDemandeRestit	string	Reason given for the request.Reason given for the request.
siretDemandeurDemandeRestit	string	SIRET identifier of the requesting organization.SIRET identifier of the requesting organization.
sirenDemandeurDemandeRestit	string	SIREN identifier of the requesting organization.SIREN identifier of the requesting organization.
justificationDemandeRestit	string	Justification provided for the request.Justification provided for the request.
codeDeviseDeviseCompte	string	Code identifying the account's currency.Code identifying the account's currency.
numeroEtablissementEtablissementBancaire	string	Identification number of the banking establishment.Identification number of the banking establishment.
libelleEtablissementEtablissementBancaire	string	Name of the banking establishment.Name of the banking establishment.
bicEtablissementEtablissementBancaire	string	BIC code of the banking establishment.BIC code of the banking establishment.
etablissementEtablissementGestionnaire	object	Banking establishment managing the account.Banking establishment managing the account.
guichetEtablissementGestionnaire	object	Branch office managing the account.Branch office managing the account.
numeroGuichetGuichetDto	string	Identification number of the bank branch.Identification number of the bank branch.
libelleGuichetGuichetDto	string	Name of the bank branch.Name of the bank branch.
adresseGuichetDto	object	Address of the bank branch.Address of the bank branch.
codeNatureNatureCompteDto	integer (int32)	Numeric code identifying the account's nature.Numeric code identifying the account's nature.
libelleNatureNatureCompteDto	string	Textual label describing the account's nature.Textual label describing the account's nature.
caracteristiquesDemandeReponseListeComptes	object	Characteristics of the account search request.Characteristics of the account search request.
referenceDemandeReponseListeComptes	string	Reference identifier of the request.Reference identifier of the request.
nombreReponsesReponseListeComptes	string	Number of responses returned for the request.Number of responses returned for the request.
messageInformatifReponseListeComptes	object	Informational message accompanying the response.Informational message accompanying the response.
comptesReponseListeComptes	array<object>	List of bank accounts returned in the response.List of bank accounts returned in the response.
verificationCompteReponseListeComptes	object	Result of the account verification check.Result of the account verification check.
reponsesReponseListeFinaleComptes	object	Final list of account responses.Final list of account responses.
ibanExistantReponseVerifCompte	string	IBAN found to exist in FICOBA.IBAN found to exist in FICOBA.
codeTypeTypeCompte	integer (int32)	Numeric code identifying the account type.Numeric code identifying the account type.
libelleTypeTypeCompte	string	Textual label describing the account type.Textual label describing the account type.
criteresRechercheDemandeRestitRechCompte	object	Search criteria used for the account request.Search criteria used for the account request.
codePaysResidenceAdresse	string	Country code of the account holder's residence.Country code of the account holder's residence.
libellePaysResidenceAdresse	string	Name of the country of residence.Name of the country of residence.
codeDepartementResidenceAdresse	string	Code of the residence department.Code of the residence department.
libelleDepartementResidenceAdresse	string	Name of the residence department.Name of the residence department.
codeCommuneResidenceAdresse	string	Code of the residence municipality.Code of the residence municipality.
libelleCommuneResidenceAdresse	string	Name of the residence municipality.Name of the residence municipality.
codeNatureVoieAdresse	string	Code identifying the type of street.Code identifying the type of street.
libelleVoieAdresse	string	Name of the street.Name of the street.
numeroVoieAdresse	string	Street number of the address.Street number of the address.
indiceRepetitionAdresse	string	Repetition index for the street number (e.g. bis, ter).Repetition index for the street number (e.g. bis, ter).
indicateurCodifAdresseAdresse	string	Indicator of the address coding standard used.Indicator of the address coding standard used.
codePostalAdresse	string	Postal code of the address.Postal code of the address.
libelleComplAdrAdresse	string	Additional address complement information.Additional address complement information.
raisonSocialePersonneMorale	string	Registered company name of the legal entity.Registered company name of the legal entity.
siglePersonneMorale	string	Acronym or abbreviation of the legal entity's name.Acronym or abbreviation of the legal entity's name.
enseignePersonneMorale	string	Trading name (brand) of the legal entity.Trading name (brand) of the legal entity.
siretPersonneMorale	string	SIRET identifier of the legal entity.SIRET identifier of the legal entity.
categorieJuridiquePersonneMorale	integer (int32)	Numeric code of the legal entity's legal category.Numeric code of the legal entity's legal category.
sirenPersonneMorale	string	SIREN identifier of the legal entity.SIREN identifier of the legal entity.
scoreAppariementPersonneMorale	number (double)	Matching score between the search and found entity.Matching score between the search and found entity.
personneRechercheReponseListeComptesPourPM	object	Legal entity searched for in the request.Legal entity searched for in the request.
nombreComptesReponseListeComptesPourPM	string	Number of accounts found for the legal entity.Number of accounts found for the legal entity.

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/refs/heads/main/swaggers/api-ficoba3.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.