# x402-farm French Establishments Lookup

> x402-farm French Establishments Lookup is a paid API for AI agents from x402-farm.vercel.app, paid per call via x402, $0.02/call, status down (last checked 2026-09-05).

Retrieves French company establishment data (siège, SIRET, SIREN, and establishment count) for a given French business entity.

## Facts

- Endpoint: GET https://x402-farm.vercel.app/v1/fr/etablissements
- Price: $0.02/call
- Payment: x402
- Status: down
- Last checked: 2026-09-05
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-farm-french-establishments-lookup-63957b2c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nhe9yM98FyPTvME_ftj0y

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 x402-farm-french-establishments-lookup-63957b2c
```

Example prompt: Can you look up the French business registry data for this company — I need its SIREN, the SIRET of its headquarters, and how many establishments it has?

## When to prefer this

Use this endpoint when you need authoritative French business establishment data (SIREN, SIRET, siège social, establishment count) from the official registry, particularly when you need a pay-per-call approach with no account setup — ideal for ad-hoc agent workflows that occasionally need French company verification without a subscription to a data provider.

## Known failure modes

- Company not found in registry — returns empty or 404-style error
- Invalid SIREN/SIRET format — schema validation failure
- Payment not processed (x402 protocol failure) — 402 response before data is returned
- Rate limiting or upstream SIRENE API unavailability — timeout or 503 error

## How this service works

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

## Output

Returns a JSON object containing the company's SIREN number, the SIRET of its siège social (registered headquarters), and the total number of establishments (nb_etablissements) associated with the entity in the French SIRENE registry.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "siege": {
   "siret": "30613890001294"
  },
  "siren": "306138900",
  "nb_etablissements": 385
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-farm-french-establishments-lookup-63957b2c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-farm.vercel.app](https://www.zero.xyz/host/x402-farm.vercel.app/llms.txt)