# Japan Business Day API

> Japan Business Day API is a paid API for AI agents from japan-business-day-api.matchan962.workers.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-11).

Checks whether a given date is a business day in Japan, returning holiday status, official holiday name in Japanese and English, and the next/previous business day.

## Facts

- Endpoint: GET https://japan-business-day-api.matchan962.workers.dev/v1/is-business-day?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/japan-business-day-api-293060af
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_BnHDyRQDmXbikMs9O97YN

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 japan-business-day-api-293060af
```

Example prompt: Is November 3, 2026 a business day in Japan? If not, what's the next business day? Please use the national calendar.

## When to prefer this

Choose this endpoint when you need authoritative Japanese business day and public holiday data sourced directly from Japan's Cabinet Office, especially when you need official bilingual holiday names or need to distinguish between national and bank holidays (e.g. the Dec 31–Jan 3 bank holiday window).

## Known failure modes

- Missing or invalid date parameter returns a 400 error
- Date outside supported range may return empty or error response
- Invalid calendar enum value may cause a 400 validation error
- Network or worker availability issues may return 5xx errors

## How this service works

Is a given date a business day in Japan? Returns weekday/holiday status, official holiday name (JA/EN) and next/previous business day. Source: Cabinet Office of Japan.

## Output

Returns a JSON object with the queried date, day of week, whether it is a holiday, the official holiday name in Japanese and English (if applicable), whether it is a business day, and the next business day date.

## 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": [
      "date"
     ],
     "properties": {
      "date": {
       "type": "string",
       "format": "date"
      },
      "calendar": {
       "enum": [
        "national",
        "bank"
       ],
       "type": "string",
       "description": "national = weekends + Japanese national holidays; bank = also Dec 31 - Jan 3 (bank holidays)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "date": "2026-11-03",
  "dayOfWeek": "Tuesday",
  "isHoliday": true,
  "holidayName": "文化の日",
  "holidayNameEn": "Culture Day",
  "isBusinessDay": false,
  "nextBusinessDay": "2026-11-04"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/japan-business-day-api-293060af/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from japan-business-day-api.matchan962.workers.dev](https://www.zero.xyz/host/japan-business-day-api.matchan962.workers.dev/llms.txt)