# Japan Business Day API – Find Auspicious Dates by Rokuyo

> Japan Business Day API – Find Auspicious Dates by Rokuyo is a paid API for AI agents from japan-business-day-api.matchan962.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-12).

Returns a list of dates within a range (up to 366 days) that match specified rokuyo lucky-day types and optional weekday filters, for scheduling ceremonies and important events in Japan.

## Facts

- Endpoint: GET https://japan-business-day-api.matchan962.workers.dev/v1/koyomi/find?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/japan-business-day-api-find-auspicious-dates-by-rokuyo-00fcaeef
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_aOGaJdC-zyKwaFjCrLAJZ

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-find-auspicious-dates-by-rokuyo-00fcaeef
```

Example prompt: Find all taian days that fall on a Saturday or Sunday between March 1 and June 30, 2025 — I'm trying to pick an auspicious weekend for a wedding in Japan.

## When to prefer this

Use this endpoint when you need to find specific auspicious Japanese calendar days (rokuyo) within a date range, especially when filtering by lucky-day type and/or weekday. Ideal for wedding planners, real-estate agents, legal professionals, or any scheduling application that must respect Japanese cultural calendar conventions. Prefer this over a generic calendar API when rokuyo classification is required.

## Known failure modes

- Date range exceeds 366 days — API rejects with an error
- Invalid rokuyo value provided — unrecognized enum returns error
- Invalid date format (non-ISO date strings) causes validation failure
- No matching dates found — returns empty list
- from date is after to date — likely returns error or empty result

## How this service works

Find auspicious dates in Japan: list days in a range (up to 366 days) matching rokuyo (e.g. taian) and optional weekdays (e.g. sat,sun) - for scheduling weddings, moving, contract signing and ceremonies.

## Output

A list of dates within the requested range that satisfy both the specified rokuyo type(s) and optional weekday constraints, allowing event planners to identify culturally auspicious days in the Japanese traditional calendar.

## 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": [
      "from",
      "to"
     ],
     "properties": {
      "to": {
       "type": "string",
       "format": "date"
      },
      "from": {
       "type": "string",
       "format": "date"
      },
      "rokuyo": {
       "type": "string",
       "description": "Comma-separated: taian,shakko,sensho,tomobiki,sakimake,butsumetsu (default taian)"
      },
      "weekdays": {
       "type": "string",
       "description": "Optional comma-separated weekdays, e.g. sat,sun"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/japan-business-day-api-find-auspicious-dates-by-rokuyo-00fcaeef/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)