🇨🇳 China Adjusted Workdays Data

The methodology behind the only API with 调休补班 (make-up workday) data — and why every other holidays API gets China wrong.

The Problem With Other APIs

China's holiday system doesn't just have holidays — it moves workdays. When a public holiday spans a week, the government schedules make-up workdays on nearby weekends. For example, in 2026, Saturday Feb 14 became a workday to compensate for the Spring Festival break.

Query	Other APIs	This API
`is-workday/CN/2026-02-14`	weekend ❌	workday ✅ (adjusted)
Payroll for Feb 2026	wrong day count	exact: 16 workdays
Delivery SLA across Golden Week	misses make-up days	correct T+N

If you calculate payroll, interest days, delivery dates, or SLA penalties involving China — make-up workdays are the difference between correct and wrong.

Our Data Source

Official State Council notices (国务院办公厅), the same documents every Chinese company's HR department uses. Each November, the State Council publishes next year's holiday arrangement. We:

Parse the official notice the day it's published
Encode every holiday and every make-up workday into our dataset
Verify against public calendars before release
Update the API immediately — usually within 24 hours of the announcement

Coverage

Complete adjusted-workday data for 2025 and 2026. The 2027 dataset will be added as soon as the State Council publishes its notice (expected November 2026).

Endpoints Using This Data

Endpoint	Use case
`GET /is-workday/CN/{date}`	Single-day check with 调休 logic
`GET /business-days-between/CN`	Workday count for payroll / interest / SLA
`GET /next-business-day/CN`	Bill due dates rolled past holidays (T+N)
`GET /business-days-in-month/CN`	Monthly workday stats for HR reports
`GET /china/adjusted-workdays/{year}`	The raw make-up workday list

Accuracy Guarantee

Found a discrepancy? Every response includes the data source, and we fix verified errors within 48 hours. Report issues via the feedback form or the API's /feedback endpoint.