# 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-10).

Looks up French companies in the official SIRENE register by SIREN, SIRET, or company name, returning legal details, status, address, and NAF activity code.

## Facts

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

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-5936a27c
```

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

## When to prefer this

Choose this endpoint when you specifically need to look up French companies in the official SIRENE/Annuaire des Entreprises register. Prefer it over generic business data providers when you need authoritative French government registry data including NAF codes, legal form, and official status. Use this rather than sibling endpoints (UK, Belgium, Norway, etc.) when the target company is registered in France. Best for compliance, due diligence, supplier verification, and CRM enrichment workflows involving French legal entities.

## Known failure modes

- No matching company found for the given SIREN/SIRET/name — returns count:0 with a note
- Invalid or malformed SIREN/SIRET number format — query rejected or zero results
- Company exists but registry data is incomplete — some fields may be null
- SIRENE register temporarily unavailable — upstream API error
- Query string too short (under 3 characters) or too long (over 200 characters) — validation error
- Payment failure via x402 — call not executed

## 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 JSON object with ISO country code (FR), registry name (SIRENE), echoed query, match count, and an array of company records each containing: current legal name, registration number, normalized status (active/inactive/unknown), legal form, founding date, structured head-office address (street, postal code, city, country code), NAF activity code(s), 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-5936a27c/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)