# French Company Registry Search (Sirene/INSEE)

> French Company Registry Search (Sirene/INSEE) is a paid API for AI agents from data.greeneris.io, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Searches the official French company registry (INSEE Sirene data) by company name or SIREN number, returning legal, financial, and operational details.

## Facts

- Endpoint: GET https://data.greeneris.io/v1/fr/company
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/french-company-registry-search-sirene-insee-3bf23ad3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mcwNn3TPjTETNa2e8c3WD

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability french-company-registry-search-sirene-insee-3bf23ad3
```

Example prompt: Can you look up Airbus in the French company registry and give me their SIREN, legal form, registered address, NAF code, and whether they're still active?

## When to prefer this

Use this endpoint when you need authoritative French company data sourced directly from the official INSEE Sirene registry, especially for KYB (Know Your Business) workflows, invoice verification, supplier onboarding, or legal due diligence on French entities. Prefer this over generic web search when structured, GDPR-compliant, daily-updated registry data is required. The sibling SIREN validation endpoint is better for pure format checks without a full registry lookup.

## Known failure modes

- No results found for an obscure or misspelled company name
- Invalid SIREN format returns a validation error
- NAF code filter typo returns empty results
- Rate limiting or upstream INSEE API unavailability
- Stale data due to 24-hour cache lag for very recent registry changes
- Per_page out of range (must be 1-10) returns an error
- Page number beyond available results returns empty dataset

## How this service works

Official French company registry search via recherche-entreprises.api.gouv.fr (INSEE Sirene data, updated daily). Query: ?q=airbus or ?q=383474814 (name or SIREN), optional per_page (1-10), page, code_postal, activite_principale (NAF, e.g. 70.10Z), etat_administratif (A active / C ceased). Returns SIREN, legal form, NAF, HQ address, employee range, status and published finances per company. Personal data on directors is stripped (GDPR). 24h cache.

## Output

Returns a paginated list of French companies matching the query, each with SIREN identifier, legal form, NAF activity code, headquarters address, employee range, administrative status (active/ceased), and any published financial data. Personal director data is excluded per GDPR. Results are cached for 24 hours.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "description": "Company name or SIREN number"
      },
      "page": {
       "type": "integer",
       "default": 1,
       "description": "Page number (1-50)"
      },
      "per_page": {
       "type": "integer",
       "default": 3,
       "description": "Results per page (1-10)"
      },
      "code_postal": {
       "type": "string",
       "description": "Filter by 5-digit postal code"
      },
      "etat_administratif": {
       "enum": [
        "A",
        "C"
       ],
       "type": "string",
       "description": "A = active, C = ceased"
      },
      "activite_principale": {
       "type": "string",
       "description": "Filter by NAF code, e.g. 70.10Z"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "page": 1,
  "source": "recherche-entreprises.api.gouv.fr (INSEE Sirene, Licence Ouverte 2.0); director personal data removed",
  "results": [
   {
    "name": "AIRBUS",
    "siren": "383474814",
    "finances": {
     "2024": {
      "ca": 57412795000,
      "resultat_net": 2206027000
     }
    },
    "naf_code": "30.30Z",
    "legal_form": "5710",
    "legal_name": "AIRBUS",
    "headquarters": {
     "city": "BLAGNAC",
     "siret": "38347481400100",
     "address": "2 ROND-POINT DEWOITINE 31700 BLAGNAC",
     "naf_code": "70.10Z",
     "postal_code": "31700"
    },
    "creation_date": "1991-10-18",
    "employee_range": "53",
    "company_category": "GE",
    "establishments_open": 6,
    "establishments_total": 11,
    "administrative_status": "A"
   }
  ],
  "total_results": 245
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/french-company-registry-search-sirene-insee-3bf23ad3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from data.greeneris.io](https://www.zero.xyz/host/data.greeneris.io/llms.txt)