# French Company Registry Lookup (SIRENE)

> French Company Registry Lookup (SIRENE) is a paid API for AI agents from companies.use.x402atlas.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-12).

Looks up French companies in the official SIRENE register by SIREN/SIRET number or company name, returning legal details in a standardized schema.

## Facts

- Endpoint: GET https://companies.use.x402atlas.com/french-company-data?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/french-company-registry-lookup-sirene-e0d9d554
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_XzM-uvGa2y6ExFP0oLAUX

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-lookup-sirene-e0d9d554
```

Example prompt: Can you look up the French company with SIREN number 552032534 in the official SIRENE register and tell me its legal name, current status, registered address, and activity code?

## When to prefer this

Use this endpoint when you specifically need to look up French companies registered in the official SIRENE/Annuaire des Entreprises registry. Prefer it over generic web search when you need structured, authoritative legal data (registration number, legal form, official status) for KYB, due diligence, CRM enrichment, or compliance workflows. It shares a consistent schema with sibling endpoints for other countries (UK, Belgium, Norway, etc.), making it ideal for multi-country company verification pipelines.

## Known failure modes

- No matches found: returns companies array as empty with count=0 and a note field explaining zero results
- Invalid or malformed SIREN/SIRET: may return no matches or an error response
- Query string too short (<3 characters) or too long (>200 characters): rejected by schema validation
- Company name ambiguity: may return multiple results requiring further filtering
- SIRENE registry temporarily unavailable: upstream data source error
- Payment failure: x402 payment not processed, endpoint returns 402

## How this service works

French company lookup in the official SIRENE register (Annuaire des Entreprises) by SIREN, SIRET or company name. Returns legal name, active/ceased status, legal form, creation date, head-office address and NAF activity code in a schema shared across countries.

## Output

Returns a structured JSON object with: echoed query, ISO country code ('FR'), registry name ('SIRENE'), match count, and an array of matching companies each containing legal name, SIREN/SIRET registration number, normalized status (active/inactive/unknown), legal form, founding date, structured head-office address (street, postal code, city, country code), NAF activity codes, and website if available.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "query"
     ],
     "properties": {
      "query": {
       "type": "string",
       "maxLength": 200,
       "minLength": 3,
       "description": "Company registration number (French SIREN or SIRET, e.g. 552032534) or company name"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "country",
      "registry",
      "query",
      "matched_by",
      "count",
      "companies"
     ],
     "properties": {
      "note": {
       "type": "string",
       "description": "Hint present only on the sample response (empty/omitted query) and on a zero-match response"
      },
      "count": {
       "type": "integer",
       "description": "Number of entries in companies"
      },
      "query": {
       "type": "string",
       "description": "Echoed query (trimmed)"
      },
      "country": {
       "type": "string",
       "description": "ISO 3166-1 alpha-2 code of the route's country"
      },
      "registry": {
       "type": "string",
       "description": "Official registry the result comes from"
      },
      "companies": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "name",
         "registration_number",
         "status",
         "legal_form",
         "founded",
         "address",
         "activities",
         "website"
        ],
        "properties": {
         "name": {
          "type": "string",
          "description": "Current legal name"
         },
         "status": {
          "enum": [
           "active",
           "inactive",
           "unknown"
          ],
          "type": "string",
          "description": "Normalized registry status: active, inactive (ceased, dissolved, bankrupt or being wound up) or unknown"
         },
         "address": {
          "type": "object",
          "required": [
           "street",
           "po
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/french-company-registry-lookup-sirene-e0d9d554/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from companies.use.x402atlas.com](https://www.zero.xyz/host/companies.use.x402atlas.com/llms.txt)