# JP Local Pack API — Japan Public Holiday Lookup

> JP Local Pack API — Japan Public Holiday Lookup is a paid API for AI agents from jp-local-pack-api.kasanegi123.workers.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Returns the list of Japanese public holidays for a given year, including names in English and Japanese, day of week, and holiday type flags.

## Facts

- Endpoint: GET https://jp-local-pack-api.kasanegi123.workers.dev/api/holiday/jp
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/jp-local-pack-api-japan-public-holiday-lookup-96455d8e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_NGk6ytIeAlDt3iQW4ezyi

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 jp-local-pack-api-japan-public-holiday-lookup-96455d8e
```

Example prompt: Can you get me the full list of Japanese public holidays for 2026, including their English and Japanese names and what day of the week they fall on?

## When to prefer this

Use this endpoint when you need authoritative Japanese public holiday data for a specific year (2024–2027) for payroll, scheduling, HR automation, or calendar logic, and want a lightweight pay-per-call approach via x402 micropayments without API key management. Prefer this over scraping or manual calendars when building automated Japan office workflows.

## Known failure modes

- Payment not provided — returns HTTP 402 with a shape-preview response where numeric fields are 0 placeholders and only the structure is shown
- Year outside 2024–2027 static embed range — may return empty or incomplete holiday list
- Invalid year parameter — API may return an error or empty holidays array
- Network timeout on Cloudflare Workers edge — transient failure, retry recommended

## How this service works

Japan payroll / tax / social insurance / mynumber / corporate / invoice / holiday reference API for AI agents. x402 micropayments on Base. No API key.

## Output

A JSON object containing the requested year, a count of holidays, and an array of holiday entries each with a date (YYYY-MM-DD), English name, Japanese name (UTF-8), day of week, and a boolean flag for kokumin no kyujitsu. Also includes a Cabinet Office attribution string and coverage notes. Static data covers 2024–2027.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "year": 2026,
  "_role": "shape_preview_echoes_query_for_paid_response",
  "count": 0,
  "holidays": [
   {
    "date": "2026-01-01",
    "name_en": "New Year's Day",
    "name_ja": "<Japanese UTF-8, e.g. Ganjitsu>",
    "day_of_week": "Thu",
    "is_kokumin_no_kyujitsu": false
   }
  ],
  "attribution": "<Cabinet Office attribution>",
  "_sample_note": "Unpaid 402 shape preview echoes the requested year; paid 200 returns the full holiday list from the 2024-2027 static embed.",
  "coverage_note": "2024-2027 static embed. 2028+ requires annual update.",
  "_shape_preview_note": "Numeric fields in this unpaid 402 shape preview are 0 placeholders. Real values require X-PAYMENT on production."
 },
 "mimeType": "application/json"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/jp-local-pack-api-japan-public-holiday-lookup-96455d8e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from jp-local-pack-api.kasanegi123.workers.dev](https://www.zero.xyz/host/jp-local-pack-api.kasanegi123.workers.dev/llms.txt)