# fr-company

> French company lookup (SIREN/SIRET/name) from the official open-data Sirene base (recherche-entreprises.api.gouv.fr, Licence Ouverte Etalab). Returns legal name, SIREN, HQ address, NAF code, status, creation date, directors when public.

- URL: https://x402-gateway.forge-x402.workers.dev/api/fr-company (GET or POST)
- Price: 0.005 USDC on Base (5000 atomic USDC)
- MCP tool: fr_company
- Docs: https://agent-hub.dentreprise.workers.dev/tools/fr-company/

## Parameters

- `q` (string, required): Company name, SIREN (9 digits) or SIRET (14 digits)

## Unpaid example

```bash
curl -sS -D - "https://x402-gateway.forge-x402.workers.dev/api/fr-company?q=danone"
```

## Example 402 challenge

```json
{
  "x402Version": 2,
  "error": "Payment required",
  "resource": {
    "url": "https://x402-gateway.forge-x402.workers.dev/api/fr-company",
    "description": "French company lookup (SIREN/SIRET/name) from the official open-data Sirene base (recherche-entreprises.api.gouv.fr, Licence Ouverte Etalab). Returns legal name, SIREN, HQ address, NAF code, status, creation date, directors when public.",
    "mimeType": "application/json"
  },
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "amount": "5000",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "payTo": "0x7B8bf45ac6AcbA6D4CFB626b57D3f5fF3C9C89F7",
      "maxTimeoutSeconds": 120,
      "extra": {
        "name": "USD Coin",
        "version": "2"
      }
    }
  ]
}
```

## Example response

```json
{
  "results": [
    {
      "siren": "552032534",
      "name": "DANONE",
      "naf": "70.10Z",
      "hq_address": "59-61 RUE LA FAYETTE 75009 PARIS",
      "active": true
    }
  ]
}
```