--- title: "Societe.com Integration" description: "Societe.com is the French company-information provider keyed on SIREN, covering identity, directors, establishments, filed accounts, trademarks, official filings and a financial health score. Agents search and verify companies, pull directors and financials, download official documents and check a company's score." url: https://flowrunner.ai/integrations/societe-com date_modified: 2026-09-04T19:38:13-07:00 --- # Societe.com [Analytics & Data](https://flowrunner.ai/integrations/category/analytics-data) Societe.com is the French company-information provider keyed on SIREN, covering identity, directors, establishments, filed accounts, trademarks, official filings and a financial health score. Agents search and verify companies, pull directors and financials, download official documents and check a company's score. 15 actions · API key · available [Societe.com website](https://societe.com/) · [Platform Documentation](https://www.societe.com/) · Capability data verified 2026-08-27 1. Sales requests payment terms for a French prospect, or an existing limit comes up for review 2. Get Account Info confirms the credit balance is sufficient before the workflow fans out 3. Check Company Exists confirms the SIREN resolves, which is the cheapest call in the API 4. Get Company Score returns the financial health scoring the decision will rest on 5. Get Company Financials, Get Company Directors, and Get Company Establishments fill in the filed accounts, the officers, and the sites 6. Agent assembles one file and posts it to the credit channel with the score and any gaps named explicitly 7. The credit committee sets the limit and the terms ## What This Integration Enables Where a register API is built for finding out who a company is, Societe.com is built for the moment you have to put a number on it. Its center of gravity is the financial health score, and the operations around it exist to justify that score: the filed annual accounts, the officers, the establishments, the trademarks, and the official filings you can download as proof. If [Pappers](https://flowrunner.ai/integrations/pappers) is the connector for watching a French portfolio over time, this is the one you call when a credit committee needs an answer this afternoon. Two properties of the API shape every workflow built on it, and both are worth designing around rather than discovering in production. Every successful call spends credits, including a well-formed lookup for a company that turns out not to exist, which is why the connector validates a SIREN locally and refuses a SIRET before either reaches the vendor. And Get Company Financials can legitimately come back empty, because French companies may lawfully request that their filed accounts stay confidential. An agent that reads that emptiness as distress is wrong in a way that costs a supplier a contract. FlowRunner agents assemble the file and name the gap; the [human-in-the-loop](https://flowrunner.ai/concepts/human-in-the-loop) step is where somebody decides what the gap means. ### Without FlowRunner **The file assembled by hand**: Somebody opens four screens and copies figures into a template before a limit can be discussed **Reviews happen when something goes wrong**: Existing limits are revisited after a late payment rather than on a schedule **Missing accounts read as bad news**: An empty financials section looks like a warning sign when it is often a lawful confidentiality choice ### With FlowRunner **The file assembled before the meeting**: Score, accounts, officers, and sites arrive together, keyed on one SIREN **Reviews run on a cadence**: The book is re-scored on a schedule and only the movements need attention **Gaps are labeled as gaps**: The agent says which data was withheld rather than leaving a blank the reader has to interpret ## Use Case Scenarios ### A credit file that is ready before the request is A deal reaches the stage where terms are discussed. The agent runs Search Companies on the trading name to resolve a SIREN and confirms it with Check Company Exists. Then it pulls the file. Get Company Score returns the health rating and Get Company Financials the filed accounts. Get Company Directors brings back the officers, Get Company Establishments the sites and their SIRETs, and Get Company Contact the registered address. Where the counterparty trades across borders, the VAT number is confirmed separately through [VIES API](https://flowrunner.ai/integrations/vies-api). The whole file appends to a review sheet in [Google Sheets](https://flowrunner.ai/integrations/google-sheets) and posts as a summary in [Slack](https://flowrunner.ai/integrations/slack) before anybody asks for it. ### Re-scoring the book on a cadence, not after an incident Once a quarter the agent walks every French customer with an active limit. Check Company Exists runs first, because it is the cheapest call and it catches the companies that have been struck off. Get Company Score runs next, and the agent compares the current rating against the one stored on the account record in [HubSpot](https://flowrunner.ai/integrations/hubspot). Only movements go anywhere: a score that fell, a company that stopped existing, a new director appearing on an account with a large exposure. Get Account Info runs before the sweep starts, because a 402 halfway through a fan-out leaves half the book unreviewed and nothing in the log to say which half. ### Building the picture around a person, not a company Sometimes the risk is not the entity in front of you. Autocomplete Directors resolves a name to a director identifier, and Get Director Mandates maps every company that person holds or has held a mandate in. That reverse view is what turns a single lookup into an ownership picture: the same officer across four entities, three of them dissolved. The agent pairs it with List Company Official Documents and Download Official Document to retrieve the filings that back it up, and files them alongside the record. Not every listed filing has a retrievable copy, so the agent reports which documents exist on the register and which are recorded but unavailable, rather than presenting a partial set as complete. ## Human-in-Loop Highlight A credit limit is a promise to carry someone else's risk, and the moment this connector makes that decision hardest is the one it is most likely to produce. Get Company Financials comes back empty for a French company that has lawfully asked for its accounts to stay confidential, which means the agent is holding a health score, a director list, an establishment list, and no filed figures at all. That is not a red flag, and it is not a clean bill either. So the agent does not set the limit. It posts what it has: "Fournitures Rhone SAS, SIREN 812345678. Score from Get Company Score is available, accounts are withheld for the last two filed years, four establishments, one director change in March. Requested terms: 60 days, 120k EUR. The quantitative basis for this limit is the score alone. Approve, reduce, or ask for accounts directly?" The credit committee answers. The agent did every hour of gathering; it declined to do the ten minutes of judgment that carries the loss if it is wrong. Agent processes routinely Detects exception requiring judgment Clear match Continues automatically Ambiguous Routes to human via preferred channel Human decides Agent resumes with decision ## Agent Capabilities 15 actions ### Search 3 - **Search Companies** Searches French companies by name and returns SIREN, trading name, status, NAF activity code, and location. This is the usual entry point, because every company operation is keyed on a SIREN rather than a name. - **Autocomplete Companies** Suggests companies from a partial name and returns a short label and SIREN for each. It is the lighter of the two lookups and suits a picker or a fuzzy match step rather than a full search. - **Autocomplete Directors** Suggests company directors from a partial name. Each suggestion carries the director identifier that the mandate lookup needs, which is an opaque string rather than a number. ### Company 7 - **Check Company Exists** Confirms that a SIREN corresponds to a real company. It is the cheapest call in the API and belongs in front of any expensive one when the SIREN arrived from outside your systems. - **Get Company Contact** Reads a company's registered contact details and address, which is what a workflow reconciles against whatever the counterparty typed on a form. - **Get Company Directors** Lists a company's directors and officers with their roles. Used for onboarding checks and for spotting governance changes on accounts already carrying exposure. - **Get Company Establishments** Lists a company's establishments, its individual sites. Each carries a SIRET, the SIREN plus a five digit site number, and says whether it is the head office. - **Get Company Financials** Reads a company's filed annual accounts. French companies may lawfully request that their accounts stay confidential, so an empty result means the filings are withheld rather than that the company is dormant, and a workflow should report it that way. - **Get Company Trademarks** Lists the trademarks registered to a company. Useful in supplier assessment and in brand disputes where the registered holder is the question. - **Get Company Score** Reads Societe.com's financial health scoring for a company. This is the credit risk signal most flows are here for, and the one that carries the weight when accounts are withheld. ### Documents 2 - **List Company Official Documents** Lists the official filings held for a company, grouped into acts and annual accounts. Entries carry a link only when the document is actually retrievable, so this call also tells you what exists but cannot be fetched. - **Download Official Document** Retrieves one official filing by the identifier the document listing returned. A filing recorded without an identifier is not available, and no other call will produce it. ### Directors 1 - **Get Director Mandates** Maps every company a director holds or has held a mandate in. This is the reverse of the company director lookup and is how a person's whole corporate footprint gets assembled. ### Account 2 - **Get Account Info** Reports the account's remaining credit balance and doubles as the connection test. Call it before a large fan-out, because every successful call spends credits and the API stops answering once they run out. - **Get Account Log** Reads the account's own call history, which is how credit spend is attributed to particular requests after the fact and how a runaway workflow gets diagnosed. ## Frequently Asked Questions ### What can FlowRunner do with Societe.com? FlowRunner agents can run Search Companies, Autocomplete Companies, and Autocomplete Directors in Societe.com, plus 12 more actions. ### Does connecting Societe.com to FlowRunner require OAuth? No. Societe.com connects to FlowRunner with an API key, no OAuth flow required. ### Can Societe.com trigger a FlowRunner workflow automatically? Societe.com doesn't currently expose triggers in FlowRunner. It connects as an action step inside workflows started by another trigger. **Work at Societe.com?** This integration exposes Societe.com to AI agents on every FlowRunner plan, including through MCP, at no cost to you. [See what FlowRunner offers integration partners](https://flowrunner.ai/integrations/partners), including how to keep this page current. --- Markdown version of https://flowrunner.ai/integrations/societe-com. Site index: https://flowrunner.ai/llms.txt