French Company by SIREN (Recherche d'entreprises)
rechercheentreprises/company-by-siren
Looks up one French company by its 9-digit SIREN and returns the register entry: legal name, legal form, activity code, size band, head-office establishment, number of establishments, financial figures when published, and the directors listed in the register (individuals included). A SIREN that is not in the register returns an empty `results` list, not an error.
activeper callv1
Price
$0.0026 per call
You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $0.50.
Data source
Recherche d'entreprises (DINUM, data.gouv.fr)
Data from Recherche d'entreprises, DINUM / data.gouv.fr, published as open access (Accès Ouvert). Served by Eden Engine; not an official DINUM or data.gouv.fr product.
Use it
Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.
Connect once and your AI can find and run this tool, and any other it needs.
agent
// 1. search: find the tool
omnial_search({ query: "what you need" })
// 2. inspect: price and input schema
omnial_inspect({ tool: "rechercheentreprises/company-by-siren" })
// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "rechercheentreprises/company-by-siren" })
// 4. run: price the exact call first, then run it
omnial_execute({ tool: "rechercheentreprises/company-by-siren", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "rechercheentreprises/company-by-siren", input: { /* ... */ } })
// 5. settle: the call is charged when it finishes, nothing to doNot connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.
Pricing
Every charge this tool can incur.
| Charge | Price |
|---|---|
Per call | $0.0026 |
- Updated
- Oct 25, 2026
Input and output schemas
Input schema
input_schema.json
{
"type": "object",
"required": [
"siren"
],
"properties": {
"siren": {
"type": "string",
"pattern": "^[0-9]{9}$",
"description": "The 9-digit SIREN, digits only, for example 855200507."
}
},
"additionalProperties": false
}Output schema
output_schema.json
{
"type": "object",
"required": [
"results",
"total_results"
],
"properties": {
"page": {
"type": "integer",
"description": "Page returned."
},
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"siren"
],
"properties": {
"siege": {
"type": "object",
"properties": {
"siret": {
"type": "string",
"description": "SIRET of the head-office establishment (14 digits)."
},
"adresse": {
"type": [
"string",
"null"
],
"description": "One-line address of the establishment."
},
"commune": {
"type": [
"string",
"null"
],
"description": "INSEE commune code."
},
"latitude": {
"type": [
"string",
"null"
],
"description": "Latitude as a string; null when the address is not geocoded."
},
"est_siege": {
"type": "boolean",
"description": "True for the head office."
},
"longitude": {
"type": [
"string",
"null"
],
"description": "Longitude as a string; null when the address is not geocoded."
},
"code_postal": {
"type": [
"string",
"null"
],
"description": "Postal code."
},
"departement": {
"type": [
"string",
"null"
],
"description": "Departement code."
},
"date_creation": {
"type": [
"string",
"null"
],
"description": "Creation date of the establishment, YYYY-MM-DD."
},
"libelle_commune": {
"type": [
"string",
"null"
],
"description": "Commune name."
},
"etat_administratif": {
"type": "string",
"description": "A for active, F for closed."
}
},
"description": "The head-office establishment (siege); an empty object on placeholder records. Further establishment fields (trade names, codes, effectif band) are passed through.",
"additionalProperties": true
},
"sigle": {
"type": [
"string",
"null"
],
"description": "Acronym."
},
"siren": {
"type": "string",
"description": "SIREN, the 9-digit company identifier."
},
"finances": {
"type": [
"object",
"null"
],
"description": "Latest published financial figures by year (revenue, net result); null when none.",
"additionalProperties": true
},
"dirigeants": {
"type": "array",
"items": {
"type": "object",
"required": [
"type_dirigeant"
],
"properties": {
"nom": {
"type": [
"string",
"null"
],
"description": "Surname of an individual director; absent or null for a corporate director (see denomination)."
},
"siren": {
"type": [
"string",
"null"
],
"description": "SIREN of a corporate director; null for individuals."
},
"prenoms": {
"type": [
"string",
"null"
],
"description": "Given names; null for a corporate director."
},
"qualite": {
"type": [
"string",
"null"
],
"description": "Role, for example Gérant or Président."
},
"nationalite": {
"type": [
"string",
"null"
],
"description": "Nationality; null when not published."
},
"denomination": {
"type": [
"string",
"null"
],
"description": "Name of a corporate director; null for individuals."
},
"type_dirigeant": {
"type": "string",
"description": "`personne physique` (individual) or `personne morale` (company)."
},
"date_de_naissance": {
"type": [
"string",
"null"
],
"description": "Month of birth (YYYY-MM) of an individual director; null when not published."
},
"annee_de_naissance": {
"type": [
"string",
"null"
],
"description": "Year of birth of an individual director; null when not published."
}
},
"description": "One director or officer listed in the register.",
"additionalProperties": true
},
"description": "Directors and officers listed in the register, individuals included."
},
"complements": {
"type": "object",
"description": "Flags such as est_association, est_ess, est_bio, est_rge and identifiers.",
"additionalProperties": true
},
"nom_complet": {
"type": [
"string",
"null"
],
"description": "Full name: legal name with the acronym when there is one; null on placeholder records."
},
"date_creation": {
"type": [
"string",
"null"
],
"description": "Creation date, YYYY-MM-DD."
},
"date_fermeture": {
"type": [
"string",
"null"
],
"description": "Closure date, YYYY-MM-DD; null while active."
},
"nature_juridique": {
"type": [
"string",
"null"
],
"description": "Legal form code (catégorie juridique INSEE), for example 5710."
},
"statut_diffusion": {
"type": [
"string",
"null"
],
"description": "O when the register is publicly diffusible."
},
"etat_administratif": {
"type": [
"string",
"null"
],
"description": "A for active, C for ceased; null on placeholder records."
},
"nom_raison_sociale": {
"type": [
"string",
"null"
],
"description": "Registered legal name."
},
"activite_principale": {
"type": [
"string",
"null"
],
"description": "Main activity (NAF rev. 2) code, for example 68.20B."
},
"categorie_entreprise": {
"type": [
"string",
"null"
],
"description": "Size category: PME, ETI, GE; null when not set."
},
"nombre_etablissements": {
"type": "integer",
"description": "Number of establishments (open and closed)."
},
"matching_etablissements": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"description": "Establishments that matched the search text."
},
"tranche_effectif_salarie": {
"type": [
"string",
"null"
],
"description": "Employee-count band code (NN means not employer or unknown)."
},
"activite_principale_naf25": {
"type": [
"string",
"null"
],
"description": "Main activity (NAF 2025) code."
},
"section_activite_principale": {
"type": [
"string",
"null"
],
"description": "Activity section letter."
},
"nombre_etablissements_ouverts": {
"type": "integer",
"description": "Number of open establishments."
}
},
"description": "One company (unité légale).",
"additionalProperties": true
},
"description": "Matching companies; empty when none match."
},
"per_page": {
"type": "integer",
"description": "Page size."
},
"total_pages": {
"type": "integer",
"description": "Number of pages."
},
"total_results": {
"type": "integer",
"description": "Total matches across all pages."
}
},
"description": "Search envelope.",
"additionalProperties": true
}