# French Company Enrichment API

> French Company Enrichment API is a paid API for AI agents from api.x-402.online, paid per call via x402, $0.080002/call, status unknown (last checked 2026-10-20).

Enriches a French company record from a name, SIREN number, or website URL, returning verified legal identity, activity code, headcount bracket, headquarters address, and current status.

## Facts

- Endpoint: POST https://api.x-402.online/v1/fr/enrich?utm_source=zero.xyz
- Price: $0.080002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/french-company-enrichment-api-20b7a5d2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DAFur3MUlHy2wHK3cg0aG

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-enrichment-api-20b7a5d2 -d '<json body>'
```

Example prompt: Can you enrich the company record for 'Doctolib' — I need their SIREN number, official headquarters address, NAF activity code, headcount bracket, and whether they're still active?

## When to prefer this

Use this endpoint when you need official, registry-backed French company data rather than scraped or user-submitted information. It is ideal for CRM enrichment, supplier onboarding verification, B2B lead qualification, and any workflow requiring verified legal identity for French entities. Prefer this over generic web search when you need structured, authoritative fields like SIREN, NAF code, or legal status.

## Known failure modes

- Company not found in French registry — returns empty or 404 if name/SIREN/domain is unrecognized
- Ambiguous name matches multiple companies — may return the most likely match or require disambiguation
- SIREN number malformed or invalid — returns validation error
- Company recently created and not yet indexed — data may be missing
- Website domain not associated with any registered entity — no result returned

## How this service works

Pay-per-call APIs for AI agents — x402 protocol, USDC on Base, no account needed.

## Output

Returns a registry-backed company record including: verified legal name, SIREN number, NAF/APE activity code, headcount bracket, registered headquarters address, and current legal status (active/closed).

## 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",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "risk": {
   "insolvency": false
  },
  "company": {
   "siren": "306138900",
   "legalName": "DECATHLON",
   "dirigeants": [
    {
     "nom": "...",
     "qualite": "President"
    }
   ]
  },
  "contact": {
   "phone": "03…",
   "website": "https://…"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/french-company-enrichment-api-20b7a5d2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.x-402.online](https://www.zero.xyz/host/api.x-402.online/llms.txt)