# French Company SIREN Search by Name

> French Company SIREN Search by Name is a paid API for AI agents from gdzlcxskuhupymyxywzm.supabase.co, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-10).

Search for French companies by name (and optional postal code) to retrieve up to 5 best-matching SIREN numbers with status, city, NAF code, headcount, and creation date

## Facts

- Endpoint: GET https://gdzlcxskuhupymyxywzm.supabase.co/functions/v1/frcompany/v1/search?utm_source=zero.xyz
- Price: $0.01/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-siren-search-by-name-f0357271
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nBYNSzlWhOIADYfrTU_aY

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-siren-search-by-name-f0357271
```

Example prompt: Can you find the SIREN number for a French company called 'Carrefour' located in postal code 92300? I need to identify them before running a full company check.

## When to prefer this

Use this endpoint when you have a French company name but not its SIREN or SIRET number, especially as the first step before calling a full KYB/company details endpoint. Prefer this over direct SIREN lookups when the user knows the company name but not the registration number. It is specifically scoped to French companies in the SIRENE registry and is ideal for onboarding workflows, CRM enrichment, and compliance pipelines requiring French business identification.

## Known failure modes

- Query string under 3 characters returns an error or empty results
- Company name too generic returns too many low-confidence matches
- Invalid postal code format causes query failure
- No matching companies found returns empty array
- Rate limiting or payment failure returns 402 error
- Non-French companies return no results since registry is France-only

## How this service works

Find a French company's SIREN from its name (optionally a postal code): up to 5 best matches with status, city, NAF, headcount and creation date. Use before /v1/company. Query: ?q=company name&postal_code=75008

## Output

Returns up to 5 best-matching French companies with their SIREN number, legal status (active/closed), city, NAF industry code, employee headcount band, and company creation date — sufficient to identify the right entity before calling the full /v1/company KYB endpoint.

## 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": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "description": "Company name, 3+ characters"
      },
      "postal_code": {
       "type": "string",
       "description": "Optional 5-digit French postal code"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/french-company-siren-search-by-name-f0357271/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from gdzlcxskuhupymyxywzm.supabase.co](https://www.zero.xyz/host/gdzlcxskuhupymyxywzm.supabase.co/llms.txt)