# Foundry Public Holidays

> Foundry Public Holidays is a paid API for AI agents from minty-sprout.onrender.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-11-01).

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

## Facts

- Endpoint: POST https://minty-sprout.onrender.com/v1/public-holidays?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/foundry-public-holidays-cfd6135e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wJOdv710vyZNCpwFHoOd6

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 foundry-public-holidays-cfd6135e -d '<json body>'
```

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

## When to prefer this

Use this endpoint when you need a structured, machine-readable list of official public holidays for a specific country and year, especially when you also need to know which holiday is coming up next. Prefer this over calendar APIs when the use case is international holiday lookup rather than personal event management, and when a lightweight pay-per-call model is preferable to a subscription.

## Known failure modes

- Invalid or unsupported country code returns an error or empty list
- Year far in the future may have incomplete or estimated holiday data
- Missing input parameters may cause a 400-level error
- Network timeout from hosted Render.com instance during cold start
- Payment failure returns 402 before any data is returned

## How this service works

Public holidays for a country and year, with the next upcoming one. Input: country code and year, e.g. 'US 2026'.

## Output

A JSON object containing the two-letter country code, year, total count of holidays, a full list of holidays (each with date, name, local name, global flag), and a 'next' field identifying the next upcoming holiday from today with its date, name, type, and metadata.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "input": {
   "type": "string",
   "maxLength": 8000,
   "description": "2-letter country code and optional year"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "next": {
   "date": "2026-11-11",
   "name": "Veterans Day",
   "fixed": false,
   "types": [
    "Public",
    "Bank"
   ],
   "global": true,
   "counties": null,
   "localName": "Veterans Day",
   "launchYear": null,
   "countryCode": "US"
  },
  "year": 2026,
  "count": 17,
  "country": "US",
  "holidays": [
   {
    "date": "2026-01-01",
    "name": "New Year's Day",
    "global": true,
    "local_name": "New Year's Day"
   },
   {
    "date": "2026-01-19",
    "name": "Martin Luther King, Jr. Day",
    "global": true,
    "local_name": "Martin Luther King, Jr. Day"
   },
   {
    "date": "2026-02-12",
    "name": "Lincoln's Birthday",
    "global": false,
    "local_name": "Lincoln's Birthday"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/foundry-public-holidays-cfd6135e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from minty-sprout.onrender.com](https://www.zero.xyz/host/minty-sprout.onrender.com/llms.txt)