Vietnam Holidays & Working Days API
Vietnamese public holidays per year (official schedules and the Labour Code rules), working-day checks, counts and “N working days later”.
The holidays API knows Vietnam’s public holidays: New Year, Tết (computed with the lunar calendar), Hung Kings Day (10/3 lunar), 30/4 and 1/5, National Day 2/9 with its extra day and, from 2026, Vietnamese Culture Day 24/11. For years whose day-off schedule has been announced (2024–2026 and Tết / 2/9 of 2027) it uses the official dates, including the weekends inside each block and the Saturdays worked to make up for a bridge day; other years follow the Labour Code: the statutory days plus a compensatory day after any that falls on a weekend.
year=2026 lists the holidays of a year with their dates and the number of working days. date= tells whether a day is a working day and why not. from=&to= counts working days, weekend days and holiday days in a range, and from=&add=10 returns the date 10 working days later (or earlier with a negative number), the usual way to compute deadlines and SLAs.
Official schedules are those for civil servants (Saturday and Sunday off). Private companies must give at least the statutory days but may choose other dates for Tết and 2/9; saturday_off=false computes a six-day week. Each holiday says whether it is official or estimated.
Parameters
| Name | In | Type | Required | Default | |
|---|---|---|---|---|---|
year | query | number | no | List the holidays of a year (2021–2199). Default: this year. | |
date | query | string | no | Check one day (YYYY-MM-DD). | |
from | query | string | no | Start of a range, or start date for add. | |
to | query | string | no | End of the range (inclusive): count working days. | |
add | query | number | no | Number of working days to add (negative: go back). | |
saturday_off | query | boolean | no | true | false: six-day week (only Sunday off). |
Example
curl "https://apibox.io.vn/v1/vn-holidays?from=2026-02-12&add=3" \
-H "Authorization: Bearer YOUR_API_KEY"const res = await fetch('https://apibox.io.vn/v1/vn-holidays?from=2026-02-12&add=3', {
method: 'GET',
headers: {
Authorization: 'Bearer YOUR_API_KEY',
},
});
const data = await res.json();
console.log(data);import requests
res = requests.get(
"https://apibox.io.vn/v1/vn-holidays?from=2026-02-12&add=3",
headers={"Authorization": "Bearer YOUR_API_KEY"},
timeout=30,
)
print(res.json())<?php
$ch = curl_init('https://apibox.io.vn/v1/vn-holidays?from=2026-02-12&add=3');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));Response
{
"from": "2026-02-12",
"add_workdays": 3,
"saturday_off": true,
"result": {
"date": "2026-02-24",
"weekday": "Tuesday",
"weekday_vi": "Thứ Ba",
"is_workday": true,
"is_weekend": false,
"is_make_up_workday": false,
"holiday": null
},
"calendar_days": 12,
"holidays_skipped": [
"Lunar New Year (Tết)"
],
"note": "Schedules marked \"official\" are those announced for civil servants…"
}Use cases
- Delivery dates and SLAs that skip Vietnamese holidays
- Leave and payroll systems: count working days in a month
- Show upcoming days off in HR and booking apps
- Plan releases and campaigns around Tết
FAQ
How many days off for Tết?
The law gives 5 days. In practice the government shifts days so that the block, with weekends, lasts 7–9 days (14–22/2/2026 for civil servants). The API returns the official block when announced.
Is 24/11 a holiday?
Yes, from 2026: Vietnamese Culture Day is a paid day off under Resolution 28/2026/QH16 (effective 1/7/2026).
What if a holiday falls on a weekend?
Employees get a compensatory day on the next working day (Labour Code, Article 111). Estimated schedules apply this rule.
Related APIs
UUID Generator
Generate up to 1,000 UUID v4, time-ordered UUID v7, ULID, Nano ID or random hex IDs per request. Secure randomness, optional uppercase.
⏱Cron Expression Parser
Validate a cron expression and get its next run times in any timezone, with a plain-English description. Supports 5, 6 and 7-field cron syntax.
🕒Time & Timezone Converter
Get the current time in any timezone, convert between timezones and Unix timestamps (seconds or ms), with UTC offset and weekday for up to 30 zones.