Pappers
Analytics & DataPappers is the French company register and legal data API over the RCS, INSEE Sirene, INPI and BODACC registers. Agents look up companies and associations by SIREN, search directors and beneficial owners, download official extracts and filings, and maintain watchlists.
What This Integration Enables
Pappers covers the French registers with unusual breadth, reaching the RCS, INSEE Sirene, INPI, and BODACC through one credential. But breadth is not what makes it worth building a workflow on. The reason to reach for this connector is that it treats a counterparty as something you keep watching rather than something you checked. Watchlists are first-class here: you create a list, add companies or named individuals to it, and Pappers tells you when something moves. Everything else in the API exists to make the moment of that alert useful.
That shapes what FlowRunner agents do with it. They read the full record with Get Company, walk ownership with Get Company Network Map, and pull the beneficial owner and director registers that anti money laundering work actually turns on. They download the official documents, from the INPI extract to the filed articles of association, straight into FlowRunner file storage so the evidence sits with the record instead of in a personal folder. They screen named individuals for sanctions and political exposure. And they keep the watchlist honest, which is the unglamorous work that decides whether any of the rest matters six months from now. The API is billed per call and the operations do not cost the same, so a well built flow checks Get Token Usage before it fans out over a list.
Without FlowRunner
With FlowRunner
Use Case Scenarios
-
Onboarding that ends with the counterparty under monitoring
A supplier is approved. The agent resolves the SIREN with Get Company Suggestions or Search Companies, then calls Get Company for the full record: legal identity, share capital, officers, beneficial owners, establishments, and recent BODACC publications. Each named beneficial owner goes through Check Individual Compliance, which requires the full identity rather than a name alone, because a partial match is not something you want to act on. Download INPI Extract and Download Beneficial Owners Declaration file the proofs. Then the step that most onboarding processes skip: Add Watchlist Companies puts the SIREN on the monitoring list with your internal supplier number stored in the comment, so a future alert can be matched back to your own records without a lookup.
-
An alert that arrives with the answer already assembled
Something changes at a monitored company. The agent responds by rebuilding the picture rather than forwarding a notification. Get Company returns the current record, Get Company Accounts brings back the filed balance sheet and income statement line items for the recent years, and Search Publications reads the BODACC entries around the change to see whether an insolvency proceeding, a business sale, or an account filing was announced. Get Company Network Map shows whether the change touched the ownership structure or only the operating entity. The result posts to Slack as a before and after, with the contract owner named, and appends to the register in Google Sheets that the compliance review works from.
-
Ownership and officer analysis across a portfolio
A review asks a question a single lookup cannot answer: which of our counterparties share an officer, and which sit behind the same beneficial owner. The agent uses Search Directors and Search Beneficial Owners across the register, which accept the same structured criteria as a company search, and cross-references the results against the account list in HubSpot. Where a pattern appears, Get Company Network Map draws the shareholders, subsidiaries, and co-directorships as nodes and edges. Search Documents runs full text against filings such as articles of association, and Download Document turns each result token into a file. Identity and score work continues in parallel through Societe.com, which is the sharper tool when the question is a credit limit rather than a structure.
Human-in-Loop Highlight
The dangerous operation on this connector is not a lookup, and it is not a download. It is Delete Watchlist, which permanently removes a monitoring list and everything it watches. Nothing breaks when it runs. No error appears. The cost arrives months later as an alert nobody received about a counterparty nobody was watching, and by then the connection between the two is invisible. There is a reversible alternative in Update Watchlist, which sets a list inactive without losing what it covers, and the same asymmetry exists in the bulk removals, where turning on Clear Everything empties a list while the call reads like a targeted change. So the agent proposes and a person disposes: "The Suppliers FR list holds 214 companies and is scheduled for deletion as part of the vendor rationalization. 31 of those SIRENs still carry open contracts. I can set the list inactive instead, which keeps the entries. Delete permanently, deactivate, or remove only the 183 closed suppliers?" The compliance owner answers. The same gate catches a quieter failure the agent flags at the same time: a watched individual added without a date of birth will never alert while strict matching is on, so an entry that looks monitored is structurally silent. An agent that can end surveillance without asking is not a labor saver. It is an unlogged risk decision, and human-in-the-loop is how FlowRunner keeps it from being one.
Agent Capabilities
39 actionsCompany Data
5- Get Company Returns everything Pappers holds on a French company, addressed by SIREN or SIRET: legal identity, address, activity codes, share capital, officers, beneficial owners, establishments, financial summaries, and BODACC publications. It is the richest call in the API and the most expensive, so reach for a narrower operation when only part of the record is needed.
- Get Association Returns the record for a French association registered under the 1901 law, addressed by its RNA identifier, SIREN, or SIRET. Associations sit in a different register, so the company lookup will not find them.
- Get Company Accounts Returns the annual accounts a company has filed, with the balance sheet and income statement line items per financial year. Not every company files publicly, so an empty result is a real answer rather than a fault.
- Get Company Network Map Returns the corporate network around a company as nodes and edges: shareholders, subsidiaries, the companies its officers also run, and the companies it is cited alongside. Use it for ownership and control analysis rather than for a single lookup.
- Get Company Suggestions Returns autocomplete suggestions for a partial company name, SIREN, SIRET, or officer name. It is the cheap, fast resolution step in front of an expensive read.
Search
5- Search Companies Searches the French register on free text and structured criteria, returning matching companies with identity, address, and headline figures. Two paging modes exist and they are not interchangeable: use the cursor when the workflow intends to read the entire result set.
- Search Directors Searches company officers and directors across the register, returning each person with the companies they run. It accepts the same structured criteria as a company search, which is what makes portfolio-level officer analysis possible.
- Search Beneficial Owners Searches the register of beneficial owners, the individuals who ultimately control a French company, returning each person with the companies they hold. This is the core read for ownership due diligence and anti money laundering checks.
- Search Documents Searches inside the full text of documents filed with the French trade register, such as articles of association and filed accounts. Each result carries a download token rather than a file.
- Search Publications Searches BODACC, the French official bulletin of civil and commercial announcements. Use it to catch insolvency proceedings, business sales, incorporations, and account filings as they are published.
Compliance
1- Check Individual Compliance Checks whether a named individual is a politically exposed person or appears on international sanctions lists. All identity parameters are required, because a name alone is not enough to make a match safe to act on. This is the screening step in front of onboarding, and its output belongs in front of a person.
Documents
8- Download Document Downloads a filed document by the token a document search returned and stores it in FlowRunner file storage. The file may be a PDF or a spreadsheet depending on what was filed, which is why a token rather than a type identifies it.
- Download Pappers Extract Downloads the Pappers extract for a company, a one page summary of legal identity, officers, and key figures. It is Pappers' own document rather than an official register extract.
- Download INPI Extract Downloads the official INPI trade register extract as a PDF. This is the one to use where proof of registration is required rather than a summary.
- Download INSEE Situation Notice Downloads the INSEE situation notice for a company or establishment, the official statement of its entry in the Sirene register. It is the document most often requested to prove a SIRET.
- Download Articles Of Association Downloads the most recent articles of association a company has filed. Not every company has filed a readable copy, so this can legitimately return nothing where the register extract succeeds.
- Download Beneficial Owners Declaration Downloads a company's filed declaration of beneficial owners. This is the source document behind the beneficial owner data and is addressed by SIREN only.
- Download Financial Report Downloads Pappers' financial report for a company, an analysis of its filed accounts with ratios and multi year trends. It is produced by Pappers rather than filed by the company, and needs enough filed accounts to exist.
- Download Non Financial Report Downloads Pappers' non financial report, covering governance, workforce, and environmental disclosures rather than accounts. Pair it with the financial report for a fuller supplier assessment.
Watchlists
5- List Watchlists Lists every monitoring list on the account with its type, alert settings, and how many entities it watches. This is the entry point to the whole monitoring feature.
- Create Watchlist Creates a monitoring list. The type is fixed at creation and cannot be changed afterwards: a companies list watches SIRENs, an individuals list watches named people.
- Get Watchlist Returns a single monitoring list with its name, type, and full alert configuration.
- Update Watchlist Updates a list's alert configuration: whether it is active, how often it fires, and where alerts are delivered. Setting it inactive silences the list without losing what it watches, which is the reversible alternative to deletion.
- Delete Watchlist Permanently deletes a monitoring list and everything it watches. This is the operation this page's human gate exists for, because nothing visibly fails when monitoring simply stops.
Watched Companies
5- List Watchlist Companies Lists the companies a list watches, each with its SIREN, the comment stored against it, and its entry identifier. The entry identifier, not the SIREN, is what the update and removal operations take.
- Add Watchlist Companies Adds one or more companies to a monitoring list. The optional comment is the intended place for your own reference, so an alert can be matched back to your records without a second lookup.
- Update Watchlist Company Updates the comment stored against a watched company, addressed by its entry identifier. The comment is the only editable field on an entry.
- Remove Watchlist Company Removes a single company from a monitoring list by entry identifier. Use it when a relationship genuinely ends rather than as routine housekeeping.
- Remove Watchlist Companies Removes several companies at once, or empties the list entirely. Supply either the entry identifiers or the clear flag, never both, because sending both would empty the list while reading like a targeted removal.
Watched Individuals
5- List Watchlist Individuals Lists the individuals a list watches, each with their name, date of birth, matching mode, and entry identifier.
- Add Watchlist Individuals Adds one or more individuals to a monitoring list. A date of birth is optional but close to essential: with strict matching on, an entry without one will never alert, and with it off the entry alerts on every namesake.
- Update Watchlist Individual Updates the comment stored against a watched individual, addressed by entry identifier.
- Remove Watchlist Individual Removes a single individual from a monitoring list by entry identifier.
- Remove Watchlist Individuals Removes several individuals at once, or empties the list entirely. As with companies, identifiers and the clear flag are mutually exclusive.
Legacy Watchlists
4- Add Companies To Legacy List Adds companies by SIREN to a version two monitoring list, kept for accounts still using the older list identifiers. New work belongs on the current watchlist operations, which support comments and per entry identifiers.
- Add Directors To Legacy List Adds officers to a version two director monitoring list. An entry may be a legal entity or an individual, and broadened matching per entry trades namesake noise for coverage where the date of birth is unknown.
- Delete Legacy List Notifications Removes notifications from a version two list, addressed by SIREN, by notification identifier, or by clearing the list. Exactly one of the three, because identifiers plus a clear flag would empty everything while looking targeted.
- Add Legacy Notification Information Attaches a short note to one or more notifications on a version two list. It is the intended place to store your own reference for the watched entity.
Account
1- Get Token Usage Returns how many API credits the account has consumed and how many remain. Pappers bills per call and different operations cost different amounts, so this is the check that belongs in front of any workflow that fans out over a list.
Frequently Asked Questions
What can FlowRunner do with Pappers?
FlowRunner agents can run Get Company, Get Association, and Get Company Accounts in Pappers, plus 36 more actions.
Does connecting Pappers to FlowRunner require OAuth?
No. Pappers connects to FlowRunner with an API key, no OAuth flow required.
Can Pappers trigger a FlowRunner workflow automatically?
Pappers doesn't currently expose triggers in FlowRunner. It connects as an action step inside workflows started by another trigger.
Other Analytics & Data integrations
Start building with Pappers
Free plan, no card required. Connect in minutes.