{"name":"entreprises_fr_search","description":"Full-text search across French legal units. Matches name, sigle, director names, addresses. Returns SIREN, denomination, establishments, sector code (APE/NAF), and basic financials.","inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"Free-text, name / director / address"},"postal_code":{"type":"string","description":"Filter to a 5-digit French postal code"},"departement":{"type":"string","description":"Filter to a French département (e.g. \"75\" Paris, \"13\" Bouches-du-Rhône)"},"ape":{"type":"string","description":"APE/NAF activity code (e.g. \"6201Z\" software dev)"},"employee_range":{"type":"string","description":"Employee count band: NN | 00 | 01 | 02 | 03 | 11 | 12 | 21 | 22 | 31 | 32 | 41 | 42 | 51 | 52 | 53 (Sirene tranche codes)"},"only_active":{"type":"boolean","description":"Restrict to currently active units (default true)"},"per_page":{"type":"number","description":"Page size, 1-25 (default 10)"},"page":{"type":"number","description":"1-based page (default 1)"}},"required":["query"],"examples":[{"query":"Acme SARL Paris"},{"query":"Sophie Martin directrice","departement":"75","ape":"6201Z","per_page":20}]},"outputSchema":{"type":"object","properties":{"results":{"type":"array","description":"Array of matching legal units","items":{"type":"object","properties":{"siren":{"type":"string","description":"9-digit SIREN identifier"},"denomination":{"type":"string","description":"Legal unit name"},"sigle":{"type":["string","null"],"description":"Abbreviated name or acronym"},"ape":{"type":"string","description":"APE/NAF activity code"},"address":{"type":"string","description":"Registered address"},"postal_code":{"type":"string","description":"5-digit postal code"},"city":{"type":"string","description":"City name"},"departement":{"type":"string","description":"French département code"},"etat_administratif":{"type":"string","description":"Administrative status (A=active, R=radiated)"},"tranche_effectif_salarie":{"type":"string","description":"Employee count band"},"etablissements":{"type":"array","description":"Registered establishments","items":{"type":"object","properties":{"siret":{"type":"string","description":"14-digit SIRET identifier"},"enseigne":{"type":"string","description":"Trading name"},"address":{"type":"string","description":"Establishment address"},"postal_code":{"type":"string","description":"5-digit postal code"},"city":{"type":"string","description":"City name"},"etat_administratif":{"type":"string","description":"Status (A=active, R=closed)"}}}},"dirigeants":{"type":"array","description":"Directors and managers","items":{"type":"object","properties":{"nom":{"type":"string","description":"Director name"},"prenom":{"type":"string","description":"Director first name"},"fonction":{"type":"string","description":"Role/title"}}}},"labels":{"type":"array","description":"RGE eco-labels or certifications","items":{"type":"string"}}}}},"total_results":{"type":"number","description":"Total number of matching results"},"page":{"type":"number","description":"Current page number"},"per_page":{"type":"number","description":"Results per page"}}},"annotations":{"readOnlyHint":true,"openWorldHint":true,"destructiveHint":false,"idempotentHint":true,"cost":{"all":1}},"version":"v1.733131cd","disclosure":{"cost":{"credits":50,"usd":"$0.0050","category":"gov","plan":"basic","basis":"list"},"auth":{"shape":"keyless","detail":"No key required — open upstream, callable as-is."},"reliability":{"measured":true,"window_days":7,"synthetic":{"checks":9,"ok_pct":100,"last_checked_day":"2026-11-22"}}},"call":"POST https://gateway.pipeworx.io/v1/tools/entreprises_fr_search"}