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). |
Write actions (0)
This connector is read-only — it exposes no write actions.Permissions
Every action above must be explicitly granted to an agent before it can be used. See Permissions for the grant model and Security for how credentials are protected.Last reviewed against the provider API: September 2026.