# French Public Holidays by Year and Zone

> French Public Holidays by Year and Zone 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 list of French public holidays for a given year and administrative zone (métropole, Alsace-Moselle, overseas territories, etc.)

## Facts

- Endpoint: GET https://x402-farm.vercel.app/v1/fr/jours-feries
- 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/french-public-holidays-by-year-and-zone-1f132201
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_NzehgjCVMGQ6YurqYoooV

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-public-holidays-by-year-and-zone-1f132201
```

Example prompt: What are all the public holidays in mainland France (métropole) for 2025?

## When to prefer this

Use this endpoint when you need authoritative, zone-aware French public holiday data without maintaining a local calendar database. It is particularly valuable when Alsace-Moselle or overseas territory rules apply, which differ from mainland France. Prefer it over generic holiday APIs when French-specific legal accuracy across zones is required.

## Known failure modes

- Missing or invalid 'annee' parameter returns an error or empty result
- Invalid zone name returns an error or defaults to métropole
- Future years may return an incomplete or projected list if not yet officially published
- Payment failure via x402 protocol returns HTTP 402 before data is served

## How this service works

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

## Output

A structured list of French public holidays for the requested year and zone, including holiday names and their calendar dates, reflecting zone-specific rules (e.g. extra holidays for Alsace-Moselle or overseas territories like Guadeloupe, Martinique, La Réunion).

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "annee": "2026",
  "jours": [
   {
    "nom": "1er janvier",
    "date": "2026-01-01"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/french-public-holidays-by-year-and-zone-1f132201/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)