# Country Calendar Preferences Lookup

> Country Calendar Preferences 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-04).

Returns the preferred calendars, first day of the week, and weekend start/end days for a given country by ISO2 code.

## Facts

- Endpoint: GET https://api.lilambd.com/calendars/countries/%7Biso2%7D?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-04
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/country-calendar-preferences-lookup-deae8bf4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_zDoa7lMcnNWFXfqBNUd2J

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 country-calendar-preferences-lookup-deae8bf4
```

Example prompt: What calendar system, first day of the week, and weekend days does Iran use? Look it up by its country code IR.

## When to prefer this

Use this endpoint when you need country-specific calendar system preferences, week start day, or weekend day configuration for localization, scheduling, or internationalization purposes. Prefer this over manual lookup tables when you need machine-readable, structured calendar metadata keyed by ISO2 country code.

## Known failure modes

- Invalid or unsupported ISO2 country code returns an error or empty result
- Unrecognized country code may return a 404 or empty data object
- Network timeout or service unavailability returns a 5xx error
- Malformed request (missing path parameter) returns 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 containing the country's preferred calendar systems (e.g. persian, gregorian, islamic), the first day of the week, the weekend start and end days, the country ISO2 code, and an attribution field. Also includes a list of calendars currently in use in that country.

## 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": {
   "country": {
    "first_day": "sat",
    "weekend_end": "fri",
    "country_iso2": "IR",
    "weekend_start": "fri",
    "calendars_preferred": "persian gregorian islamic"
   },
   "week_rule": {},
   "calendars_in_use": [
    {
     "calendar_id": "persian"
    }
   ]
  },
  "attribution": "..."
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/country-calendar-preferences-lookup-deae8bf4/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)