# GadgetHumans Holidays Lookup API

> GadgetHumans Holidays Lookup API is a paid API for AI agents from api.gadgethumans.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-10).

Returns public holidays for a given country and year

## Facts

- Endpoint: GET https://api.gadgethumans.com/holidays?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gadgethumans-holidays-lookup-api-e235f40d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_JoF5cBT2Dte0tUovFPiLX

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 gadgethumans-holidays-lookup-api-e235f40d
```

Example prompt: Can you get me a list of all public holidays in Germany for 2025?

## When to prefer this

Use this endpoint when you need a quick, low-cost lookup of official public holidays by country and year without requiring an API key. Prefer this over calendar APIs when you only need holiday data and not full calendar management. At $0.002 per call it is suitable for high-frequency or batch lookups by country.

## Known failure modes

- Invalid or unsupported country code returns an error or empty result
- Invalid year format may result in an error response
- Missing required parameters (year or country) may return a validation error
- Very recent or future years may have incomplete holiday data
- Payment failure via x402 protocol blocks the request

## How this service works

MCP server with 49 developer tools + 300+ REST APIs — agent memory, QR codes, passwords, AI text, finance, health, crypto, weather, and more. Free tier, no API key needed.

## Output

A list of public holidays for the specified country and year, including holiday names and their corresponding dates. The response is structured as a JSON object indicating success and containing the holiday data for the requested country and year.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "year": {
   "type": "string",
   "description": "Parameter: year"
  },
  "country": {
   "type": "string",
   "description": "Parameter: country"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "ok": true
}
```

## More

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