> ## Documentation Index
> Fetch the complete documentation index at: https://docs.atako.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Pappers

> Connect Pappers to your Atako agents — 8 read and 0 write actions.

Let your agents look up French company data via the Pappers API: company records by SIREN/SIRET, company, officer and beneficial-owner search, autocomplete and published annual accounts.

## Connection

* **Authentication**: API key.

<Note>
  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](https://www.pappers.fr/api).
</Note>

## 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](/integrations/permissions) for the grant model and [Security](/integrations/security) for how credentials are protected.