# agentsvc.io Holiday Lookup API

> agentsvc.io Holiday Lookup API is a paid API for AI agents from agentsvc.io, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-10).

Returns public holidays for a given country, region, and year, and checks whether a specific date is a holiday.

## Facts

- Endpoint: POST https://agentsvc.io/api/v1/proxy/holidays?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentsvc-io-holiday-lookup-api-2d513499
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_62QcYn1zxLd5ZM1B87lBt

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 agentsvc-io-holiday-lookup-api-2d513499 -d '<json body>'
```

Example prompt: Can you check if October 3rd 2026 is a public holiday in Germany and also list all public holidays in Bavaria (BY) for 2026 in English?

## When to prefer this

Choose this endpoint when you need structured public holiday data for a specific country or subnational region, especially when you also need to validate whether a particular date falls on a holiday. It is particularly useful for scheduling, compliance, HR calendar generation, or date validation workflows where no API key setup is desired and per-call USDC micropayment via x402 is acceptable.

## Known failure modes

- Unsupported country code returns an error or empty holiday list
- Invalid date format (non-YYYY-MM-DD) may cause a validation error
- Region code not recognized for the given country returns empty or error
- Payment failure via x402 / insufficient USDC balance blocks the call
- Missing required fields (country) may result in a 400 bad request

## How this service works

86 APIs for AI agents: web scraping and crawling to Markdown, AI summaries, data extraction and cited answers, screenshots and PDF, PDF, OCR and document conversion, news, paper and developer search and more, paid per call with USDC on Base, Solana, Polygon or Arbitrum via x402. No account, no API key, free sample on every service.

## Output

Returns a JSON object containing the year, country, region, total holiday count, and an array of holiday objects each with date, name, type, and substitute flag. If a specific date was provided, also returns a date_check object with the date's weekday, holiday name if applicable, and a boolean is_holiday field.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "date": {
   "type": "string",
   "description": "YYYY-MM-DD to check"
  },
  "year": {
   "type": "integer"
  },
  "region": {
   "type": "string",
   "description": "State/region code, e.g. BY, CA, ZH"
  },
  "country": {
   "type": "string",
   "description": "ISO 3166-1 alpha-2 country code"
  },
  "language": {
   "type": "string",
   "description": "Language for holiday names, e.g. en"
  },
  "include_observances": {
   "type": "boolean",
   "default": false
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "year": 2026,
   "count": 14,
   "region": "BY",
   "country": "DE",
   "holidays": [
    {
     "date": "2026-01-01",
     "name": "Neujahr",
     "type": "public",
     "substitute": false
    },
    {
     "date": "2026-01-06",
     "name": "Heilige Drei Könige",
     "type": "public",
     "substitute": false
    }
   ],
   "date_check": {
    "date": "2026-10-03",
    "name": "Tag der Deutschen Einheit",
    "weekday": "Saturday",
    "is_holiday": true
   }
  },
  "success": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentsvc-io-holiday-lookup-api-2d513499/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentsvc.io](https://www.zero.xyz/host/agentsvc.io/llms.txt)