# Trusted Information API — Public Holidays Lookup

> Trusted Information API — Public Holidays Lookup is a paid API for AI agents from api.trustedinformation.site, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-14).

Returns a list of public holidays for a given country and year, including the next upcoming holiday.

## Facts

- Endpoint: GET https://api.trustedinformation.site/api/geo/holidays
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/trusted-information-api-public-holidays-lookup-8677093c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uDG1dZ8ODbJNVAPDT2iLx

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 trusted-information-api-public-holidays-lookup-8677093c
```

Example prompt: What are all the public holidays in the UK for 2025, and which one is coming up next?

## When to prefer this

Choose this endpoint when you need structured, per-country public holiday data without signup or API keys, billed only on success at $0.002 USDC per call via x402. It is ideal for agents that need to check upcoming holidays, build scheduling logic, or enrich calendars across multiple countries. Prefer over manual scraping or free-tier APIs when you need reliable official-source data with pay-per-use pricing and no subscription overhead.

## Known failure modes

- Missing or invalid 'country' query parameter returns an error — country is required
- Unsupported country code returns empty or error response
- Invalid year format may return an error or default to current year
- Network timeout or upstream Nager.Date unavailability could cause failed call (not charged)

## How this service works

Pay-per-call UK company, property and crypto market data for AI agents via x402. Official sources, no signup, no API keys, failed calls never charged.

## Output

A JSON object containing the country code, year, total holiday count, a full array of holidays (each with date, local name, English name, regions, and nationwide flag), and a 'next' field pointing to the nearest upcoming holiday with its date and name. Data is sourced from Nager.Date public holidays.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "country"
     ],
     "properties": {
      "year": {
       "type": "string",
       "description": "Year (default current)"
      },
      "country": {
       "type": "string",
       "description": "ISO 2-letter country code, e.g. GB, US, DE"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "country",
      "year",
      "holidays"
     ],
     "properties": {
      "next": {
       "type": [
        "object",
        "null"
       ]
      },
      "year": {
       "type": "number"
      },
      "count": {
       "type": "number"
      },
      "country": {
       "type": "string"
      },
      "holidays": {
       "type": "array"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "next": {
   "date": "2026-08-31",
   "name": "Summer Bank Holiday"
  },
  "year": 2026,
  "count": 14,
  "source": "Nager.Date public holidays",
  "country": "GB",
  "holidays": [
   {
    "date": "2026-01-01",
    "name": "New Year's Day",
    "regions": [
     "GB-ENG",
     "GB-SCT",
     "GB-WLS",
     "GB-NIR"
    ],
    "localName": "New Year's Day",
    "nationwide": false
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/trusted-information-api-public-holidays-lookup-8677093c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.trustedinformation.site](https://www.zero.xyz/host/api.trustedinformation.site/llms.txt)