Vietnam Tax Calendar API

Q: Are extensions included?

With `extension=true` for 2026, the extended payment dates of NĐ 245/2026/NĐ-CP are added; filing deadlines do not change.

Vietnamese tax deadlines for a year: VAT, PIT, provisional CIT, annual finalisation, moved past weekends and holidays, with extensions and ICS export.

GETPOSThttps://apibox.io.vn/v1/vn-tax-calendar

Data & JSON▶ Try it online

Pick a year, the entity (company or household business) and the filing periods, and get every tax deadline falling in that year: monthly returns on the 20th, quarterly returns on the last day of the following month, provisional CIT on day 30, annual CIT / PIT finalisation and financial statements at the end of the 3rd month after the fiscal year, individual PIT finalisation at the end of April, and the household-business calendar of NĐ 68/2026/NĐ-CP.

Every date that falls on a weekend or a public holiday is moved to the next working day (NĐ 252/2026/NĐ-CP Điều 3), using the official day-off schedules of our Vietnamese holiday calendar; moved_because says why. The business licence fee (due 30/1) is only listed up to 2025: it was abolished from 1/1/2026 by Nghị quyết 198/2025/QH15.

extension=true adds the payment deadlines extended by NĐ 245/2026/NĐ-CP for eligible taxpayers. month and upcoming=true filter the list, and format=ics returns a calendar file with a reminder 3 days before each deadline.

Parameters

Name	In	Type	Required	Default
`year`	query\|body	number	no		Year (default this year).
`entity`	query\|body	string	no	`company`	`company` or `household`.
`vat_period`	query\|body	string	no	`monthly`	`monthly`, `quarterly` or `none` (households: quarterly by default).
`pit_period`	query\|body	string	no		PIT withholding period (default = vat_period).
`fiscal_year_end_month`	query\|body	number	no	`12`	Last month of the fiscal year.
`extension`	query\|body	boolean	no		Add NĐ 245/2026 extended payment dates.
`month`	query\|body	number	no		Only deadlines in this month.
`upcoming`	query\|body	boolean	no		Only deadlines from today.
`format`	query\|body	string	no	`json`	`json` or `ics` (calendar file).

Example

curl "https://apibox.io.vn/v1/vn-tax-calendar?year=2026&vat_period=quarterly&month=7" \
  -H "Authorization: Bearer YOUR_API_KEY"

const res = await fetch('https://apibox.io.vn/v1/vn-tax-calendar?year=2026&vat_period=quarterly&month=7', {
  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-tax-calendar?year=2026&vat_period=quarterly&month=7",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    timeout=30,
)
print(res.json())

<?php
$ch = curl_init('https://apibox.io.vn/v1/vn-tax-calendar?year=2026&vat_period=quarterly&month=7');
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

{
  "year": 2026,
  "entity": "company",
  "vat_period": "quarterly",
  "pit_period": "quarterly",
  "deadlines": [
    {
      "period": "2026-Q2",
      "kind": "cit",
      "title_vi": "Tạm nộp thuế TNDN quý 2/2026",
      "title_en": "Provisional CIT payment, Q2 2026",
      "due_date": "2026-07-30",
      "statutory_date": "2026-07-30",
      "moved": false,
      "ref": "NĐ 126/2020/NĐ-CP Điều 55 (ngày 30 tháng đầu quý sau)"
    },
    {
      "period": "2026-Q2",
      "kind": "pit",
      "title_vi": "Khai, nộp thuế TNCN khấu trừ quý 2/2026",
      "title_en": "PIT withholding return, Q2 2026",
      "due_date": "2026-07-31",
      "statutory_date": "2026-07-31",
      "moved": false,
      "ref": "NĐ 252/2026/NĐ-CP Điều 10 khoản 3"
    },
    {
      "period": "2026-Q2",
      "kind": "vat",
      "title_vi": "Khai, nộp thuế GTGT quý 2/2026",
      "title_en": "VAT return and payment, Q2 2026",
      "due_date": "2026-07-31",
      "statutory_date": "2026-07-31",
      "moved": false,
      "ref": "NĐ 252/2026/NĐ-CP Điều 10 khoản 3"
    }
  ],
  "count": 3,
  "notes": [
    "Due dates falling on a weekend or public holiday move to the next working day (NĐ 252/2026/NĐ-CP Điều 3 khoản 7)."
  ],
  "reviewed": "2026-11-11"
}

Use cases

Send deadline reminders from accounting or HR software
Feed a Zalo or Telegram bot that reminds clients to file
Subscribe to the tax calendar in Google Calendar or Outlook
Plan the monthly workload of an accounting service

FAQ

What happens when a deadline is a Sunday or holiday?

It moves to the next working day; the answer keeps the statutory date and gives the reason (e.g. Chủ nhật, Quốc khánh).

Is the licence fee (lệ phí môn bài) still listed?

Only for years up to 2025. Nghị quyết 198/2025/QH15 ended the licence fee from 1/1/2026.

Are extensions included?

With extension=true for 2026, the extended payment dates of NĐ 245/2026/NĐ-CP are added; filing deadlines do not change.

Related APIs

{✓}

Vietnam Tax Calendar API

Parameters

Example

Response

Use cases

FAQ

Related APIs

JSON Validator

JSON Formatter

CSV to JSON