# x402-farm French Postal Code Lookup

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

Returns the commune names and INSEE codes associated with a French postal code (code postal).

## Facts

- Endpoint: GET https://x402-farm.vercel.app/v1/fr/codes-postaux
- Price: $0.005/call
- Payment: x402
- Status: down
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-farm-french-postal-code-lookup-b40361f3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_NmXerRLuCW37p_XWLUwtY

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-postal-code-lookup-b40361f3
```

Example prompt: What communes are associated with the French postal code 97110, and what are their INSEE codes?

## When to prefer this

Use this endpoint when you need to resolve French postal codes (including overseas territories like Guadeloupe, Martinique, Réunion) to their official commune names and INSEE codes. It is pay-per-call with no account setup required, making it ideal for low-volume or one-off agent tasks. Prefer this over building your own dataset when you need quick, authoritative administrative data for French addresses.

## Known failure modes

- Invalid or non-existent postal code returns empty communes array or error
- Payment failure via x402 protocol prevents access to the endpoint
- Overseas territory postal codes may have limited coverage
- Rate limits or quota exhaustion on the pay-per-call service

## How this service works

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

## Output

A JSON object containing the postal code (cp field) and an array of communes, each with a nom (commune name) and insee (INSEE administrative code). Multiple communes may share the same postal code.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "cp": "97110",
  "communes": [
   {
    "nom": "Pointe-à-Pitre",
    "insee": "97120"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-farm-french-postal-code-lookup-b40361f3/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)