Connection
- Authentication: API key.
Create an API account at pappers.fr/api (S’inscrire), then sign in and open your member area (Mon compte) to activate your API key and copy it. Each call consumes Pappers credits: a free credit pack is offered when the account is created with a professional email, more credits are bought on pappers.fr/api.See Pappers’s documentation.
Read actions (8)
| Action | Description |
|---|---|
get_annual_accounts | Get the published annual accounts (comptes annuels) of a company, detailed with their ratios, keyed by closing year. Consumes Pappers credits. Arguments: siren (string, 9 digits, required), annee (string, optional — closing year(s), comma-separated such as “2022,2023”; all available years when omitted). |
get_association | Get the record of a French association. Consumes Pappers credits. Arguments: exactly one of id_association (string, RNA identifier such as “W142005389”), siren (string, 9 digits) or siret (string, 14 digits). |
get_company | Get the full legal record of a French company (identity, NAF code, legal form, registered office and establishments, officers, beneficial owners, financials, BODACC publications…). Consumes Pappers credits on every call, plus extra credits for some champs_supplementaires. Arguments: siren (string, 9 digits) or siret (string, 14 digits — only that establishment is returned in etablissement), exactly one of the two; champs_supplementaires (string, optional — comma-separated extra fields, e.g. “sites_internet,telephone”; several cost extra credits: telephone/email/lien_linkedin 3, scoring_financier 30…), format_publications_bodacc (“objet” | “texte”, optional, default “objet”), validite_tva_intracommunautaire (boolean, optional — check the intra-EU VAT number with the European Commission), publications_bodacc_brutes (boolean, optional — raw BODACC publications, outdated ones included), autoriser_absence_insee (boolean, optional — also return the rare companies unknown to INSEE instead of a 404). |
get_credit_usage | Get the Pappers credit usage of the API key: monthly subscription credits (jetons_abonnement), subscription credits used (jetons_abonnement_utilises) and remaining pay-as-you-go credits (jetons_pay_as_you_go_restants). Free — consumes no credits. No arguments. |
search_beneficial_owners | Search beneficial owners (bénéficiaires effectifs); each result lists up to 100 companies they own and those they manage. Consumes Pappers credits per result returned — keep par_page small. All arguments optional: q (string — last and/or first name), date_de_naissance_beneficiaire_min / date_de_naissance_beneficiaire_max (string, DD-MM-YYYY), nationalite_beneficiaire (string, e.g. “Française”), siren (string, 9 digits — beneficial owners of that company), code_naf (string, NAF code such as “70.10Z”, comma-separated for several), departement (string, e.g. “75”, comma-separated), region (string, INSEE region code, comma-separated), code_postal (string, comma-separated), categorie_juridique (string, INSEE legal category code such as “5499”; SASU = 5720, EURL = 5498), entreprise_cessee (boolean — ceased activity or not), statut_rcs (“inscrit” | “radie” | “non inscrit” — RCS registration status), page (integer ≥1, default 1), par_page (integer ≥1, default 10; page-based pagination is limited to the first 400 results), precision (“approximative” | “standard” | “exacte”, default “standard”). |
search_companies | Search French companies matching criteria; returns resultats and total. Consumes Pappers credits per result returned — keep par_page small. All arguments optional: q (string — company name, or last and first name for a sole proprietor), code_naf (string, NAF code such as “70.10Z”, comma-separated for several), departement (string, e.g. “75”, comma-separated), region (string, INSEE region code, comma-separated), code_postal (string, comma-separated), categorie_juridique (string, INSEE legal category code such as “5499”; SASU = 5720, EURL = 5498), entreprise_cessee (boolean — ceased activity or not), statut_rcs (“inscrit” | “radie” | “non inscrit” — RCS registration status), objet_social (string — corporate purpose declared at the RCS), convention_collective (string, collective agreement IDCC code), date_creation_min / date_creation_max (string, DD-MM-YYYY), chiffre_affaires_min / chiffre_affaires_max, resultat_min / resultat_max, capital_min / capital_max (number or numeric string, euros — revenue and profit filters drop every company whose accounts are not published), tranche_effectif_min / tranche_effectif_max (string, Sirene headcount band code: “NN”, “00”, “01”, “02”, “03”, “11”, “12”, “21”, “22”, “31”, “32”, “41”, “42”, “51”, “52”, “53”), page (integer ≥1, default 1), par_page (integer ≥1, default 10; page-based pagination is limited to the first 400 results), precision (“approximative” | “standard” | “exacte”, default “standard”), curseur (string, ”*” for the first call then the returned curseurSuivant — alternative to page to walk beyond 400 results), par_curseur (integer 1–1000, default 50). |
search_officers | Search company officers (dirigeants); each result lists up to 100 of the companies they manage. Consumes Pappers credits per result returned — keep par_page small. All arguments optional: q (string — last and first name of a natural person, or name of a legal entity), nom_dirigeant, prenom_dirigeant (string — last name, first name), date_de_naissance_dirigeant_min / date_de_naissance_dirigeant_max (string, DD-MM-YYYY), type_dirigeant (“physique” | “morale”), qualite_dirigeant (string, role such as “Président” or “Gérant”), nationalite_dirigeant (string, e.g. “Française”), siren (string, 9 digits — officers of that company), code_naf (string, NAF code such as “70.10Z”, comma-separated for several), departement (string, e.g. “75”, comma-separated), region (string, INSEE region code, comma-separated), code_postal (string, comma-separated), categorie_juridique (string, INSEE legal category code such as “5499”; SASU = 5720, EURL = 5498), entreprise_cessee (boolean — ceased activity or not), statut_rcs (“inscrit” | “radie” | “non inscrit” — RCS registration status), page (integer ≥1, default 1), par_page (integer ≥1, default 10; page-based pagination is limited to the first 400 results), precision (“approximative” | “standard” | “exacte”, default “standard”). |
suggest | Autocomplete companies from the start of a text (fast way to find a SIREN from a name). Consumes Pappers credits per result returned — keep longueur small. Arguments: q (string, required — beginning of the text), longueur (integer 1–100, optional, default 10 — number of results), cibles (string, optional — comma-separated targets among nom_entreprise, denomination, nom_complet, representant, siren, siret; default “nom_entreprise”; one resultats_<cible> list is returned per target). |