# Asiaref Public Holidays by Country

> Asiaref Public Holidays by Country is a paid API for AI agents from asiaref.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-20).

Returns official public holidays for an Asian country, cited to the official gazette or government source, with date, name, and source URL.

## Facts

- Endpoint: GET https://asiaref.dev/v1/holidays/%7Bcountry%7D?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/asiaref-public-holidays-by-country-c35a8122
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_EiKqsma7a6-JVPF1_sReK

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 asiaref-public-holidays-by-country-c35a8122
```

Example prompt: Can you fetch the official public holidays for Japan this year from Asiaref, cited to the government gazette?

## When to prefer this

Choose this endpoint when you need authoritative, gazette-cited public holiday data for Asian countries — especially for compliance, payroll, or legal purposes where an official source URL is required. Prefer it over general calendar APIs when citation provenance matters. Use when working within the 28-country Asian coverage set and needing structured JSON output with last-confirmed dates.

## Known failure modes

- Unsupported country returns an explicit refusal or 402 error
- Invalid or unrecognized country code returns a 400 or error object
- Data may be stale if last-confirmed date is old — check the last_confirmed field
- Payment not included or insufficient results in 402 Payment Required
- Rate limit exceeded on free tier (50 calls/day) returns 429

## How this service works

Asian government reference data for 28 countries as cited JSON: central-bank policy rates, VAT/GST and VAT registration thresholds, CPI, corporate, personal and withholding tax, social contributions, minimum wages, statutory interest, official FX rates, filing deadlines and public holidays (coverage varies by country). Every value carries its official source URL and last-confirmed date. Single facts $0.003; country brief (every series for one country) $0.01; cross-country compare (one series, up to 10 countries) $0.02; tax-ID and VAT-number checks $0.003; computed answers (VAT, income tax, working days, minimum-wage check) $0.01-$0.02. Pay per call in USDC on Base via x402 or MPP, no signup, or by card with credit packs or monthly plans on one key valid across all 7 regional services. Free tier: GET /catalog, plus a free email key with 50 answer calls a day, commercial use allowed. Finished answers, one cited dossier per call (supported countries vary per job; others are refused free): cost this hire (wage-floor verdict, contributions, employer cost) $0.50; charge this sale (which VAT applies, net/VAT/gross) $0.50; charge this sale certified (plus a signed VAT-rate extract) $0.75; invoice due date and statutory late interest $0.40; country evidence pack (brief plus signed extracts) $0.25; hire compare $0.75 for 2 countries, $1.00 for 3-5; next filings (VAT, PAYE, corporate-tax due dates rolled for holidays) $0.35.

Free trial: 3 computed-answer calls per day per IP on POST /v1/answers/* with header X-Free-Trial: 1 (without it, the normal x402 402; once used up, the 402 carries free_trial_resets_at). MCP answer tools use the trial automatically when no api_key is passed. Every series of the evaluation country is free. Card credit (same per-call price as x402): /pricing.

## Output

A JSON array of public holiday objects for the requested Asian country, each containing the holiday date, local and English name, official source URL (gazette or government portal), and the last-confirmed date of the data. Coverage varies by country.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/asiaref-public-holidays-by-country-c35a8122/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from asiaref.dev](https://www.zero.xyz/host/asiaref.dev/llms.txt)