# lilambd Calendars — Festival Lookup

> lilambd Calendars — Festival Lookup is a paid API for AI agents from api.lilambd.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-11-06).

Returns a paginated list of religious and cultural festival dates across multiple calendar systems (Hebrew, etc.), sourced from Unicode CLDR data.

## Facts

- Endpoint: GET https://api.lilambd.com/calendars/festivals?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-06
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/lilambd-calendars-festival-lookup-18facd24
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_zOzTqFrTM-iLWDeTVaexB

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 lilambd-calendars-festival-lookup-18facd24
```

Example prompt: Can you look up all the festivals in the Hebrew calendar for 2027, showing up to 20 results starting from the beginning?

## When to prefer this

Choose this endpoint when you need structured, authoritative festival and holiday date data across cultural calendar systems (especially Hebrew), sourced from Unicode CLDR. Prefer it over scraping Wikipedia or using generic date libraries when you need machine-readable holiday records with calculation rules and stable festival IDs for downstream scheduling or display logic.

## Known failure modes

- Invalid or unsupported calendar_id returns empty data array
- Payment not provided or insufficient USDC results in HTTP 402
- Offset beyond total count returns empty data array with count 0
- Malformed query parameters may return a 400 error

## How this service works

A crossing for play, feeling, language, science and computation — creating states that do not have names yet.

## Output

A JSON object with a 'data' array of festival records (each containing date, name_en, calendar_id, festival_id, and calculation rule), plus count, limit, offset for pagination, and an attribution string crediting Unicode CLDR 49.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "required": {
   "type": "string"
  },
  "properties": {
   "type": "string"
  },
  "additionalProperties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [
   {
    "date": "2027-03-23",
    "rule": "Hebrew month 13/14 (Nisan=1)",
    "name_en": "Purim",
    "calendar_id": "hebrew",
    "festival_id": "purim"
   }
  ],
  "count": 1,
  "limit": 20,
  "offset": 0,
  "attribution": "Unicode CLDR 49 ..."
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/lilambd-calendars-festival-lookup-18facd24/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.lilambd.com](https://www.zero.xyz/host/api.lilambd.com/llms.txt)