# Abstract Holidays Lookup

> Abstract Holidays Lookup is a paid API for AI agents from Holidays at abstract-holidays.mpp.paywithlocus.com, paid per call via MPP, $0.006/call, status unknown (last checked 2026-10-10).

Looks up public holidays, observances, and religious events for a given country and optional date (month/year/day)

## Facts

- Endpoint: POST https://abstract-holidays.mpp.paywithlocus.com/abstract-holidays/lookup?utm_source=zero.xyz
- Price: $0.006/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Provider: Holidays
- Docs: https://docs.abstractapi.com/api/holidays
- Website: https://www.abstractapi.com/api/holidays-api
- Tags: holidays, countries, public-holidays, data
- Canonical page: https://www.zero.xyz/c/holidays-lookup-3837899c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Prc146IjGe2XIdtP7ZuoC

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 holidays-lookup-3837899c -d '<json body>'
```

Example prompt: What public holidays and observances are happening in the US in December 2024? Use the Abstract Holidays API with country code US, month 12, year 2024.

## When to prefer this

Use this endpoint when you need structured holiday and observance data for a specific country, optionally filtered by month, year, or day. It covers 200+ countries and returns rich metadata including holiday type, regional location, and local name — making it ideal for calendar apps, scheduling tools, HR software, or any workflow that needs to account for public holidays globally.

## Known failure modes

- Missing required 'country' field returns a validation error
- Invalid ISO country code returns empty results or error
- Querying a country with no data returns an empty array
- Malformed date values (e.g. month=13) may return errors or unexpected results
- Rate limiting or payment failure returns a 402 or 429 error

## How this service works

Lookup

## Output

Returns an array of holiday objects for the queried country/date, each containing the holiday name, localized name, type (e.g. public holiday, Christian, UN observance, local observance), date, day of week, location (including sub-national region if applicable), language, and an optional description.

## Example request

```json
{
 "year": 2024,
 "month": 12,
 "country": "US"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/holidays-lookup-3837899c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from abstract-holidays.mpp.paywithlocus.com](https://www.zero.xyz/host/abstract-holidays.mpp.paywithlocus.com/llms.txt)