Vietnam sale calendar API

Q: Why are mid-month and payday sales hidden?

They repeat every month; add `all=1` or `kinds=mid_month,payday` to include them.

E-commerce and marketing dates in Vietnam for any year: double days, payday, Tết, 8/3, 20/10, 20/11, Vu Lan, Black Friday, Online Friday, as JSON or ICS.

GEThttps://apibox.io.vn/v1/vn-sale-calendar

Data & JSON▶ Try it online

Lists the shopping and marketing anchors of a year in Vietnam: double-day sales (1.1 to 12.12, with 11.11 and 12.12, the National E-commerce Day), mid-month and payday sales, Valentine’s Day, 8/3, Mother’s and Father’s Day, 1/6, Vietnamese Family Day, back-to-school, 20/10, Halloween, 20/11, Black Friday and Cyber Monday, Online Friday, Christmas, and the lunar dates computed with the Vietnamese lunar calendar: Tết and its shopping season, ông Công ông Táo, God of Wealth day, Rằm tháng Giêng, Vu Lan and Mid-Autumn.

Each event has its weekday, the industries it matters for and a suggested campaign start (lead days before). format=ics returns a calendar file to import into Google Calendar or Outlook; kinds, from and to filter the list.

Online Friday is announced each year by the Ministry of Industry and Trade; unannounced years use the first Friday of December and are marked estimated. Marketplaces announce their own campaign schedules around these anchors.

Parameters

Name	In	Type	Required	Default
`year`	query	number	no		Year (default: current year).
`kinds`	query	string	no		Comma list: `double_day`, `mid_month`, `payday`, `holiday`, `season`, `global_sale`, `national_sale`, `lunar`, `tet`.
`all`	query	boolean	no		Include the monthly mid-month and payday sales.
`from, to`	query	string	no		Date range (YYYY-MM-DD).
`format`	query	string	no	`json`	`json` or `ics`.
`lang`	query	string	no	`vi`	Event titles in the ICS file: `vi` or `en`.

Example

curl "https://apibox.io.vn/v1/vn-sale-calendar?year=2027&kinds=tet,national_sale" \
  -H "Authorization: Bearer YOUR_API_KEY"

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

<?php
$ch = curl_init('https://apibox.io.vn/v1/vn-sale-calendar?year=2027&kinds=tet,national_sale');
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": 2027,
  "count": 5,
  "events": [
    {
      "date": "2027-01-07",
      "name": "Tết 2027 shopping season starts",
      "name_vi": "Bắt đầu mùa mua sắm Tết 2027",
      "kind": "tet",
      "industries": [
        "gift baskets",
        "F&B",
        "fashion",
        "home decor"
      ],
      "lead_days": 30,
      "weekday": "Thursday",
      "campaign_start": "2026-12-08"
    },
    {
      "date": "2027-01-30",
      "name": "Kitchen Gods Day (ông Công ông Táo)",
      "name_vi": "Ông Công ông Táo (23 tháng Chạp)",
      "kind": "tet",
      "industries": [
        "offerings",
        "F&B"
      ],
      "lead_days": 7,
      "weekday": "Saturday",
      "campaign_start": "2027-01-23"
    },
    {
      "date": "2027-02-05",
      "name": "Lunar New Year’s Eve (Giao thừa)",
      "name_vi": "Giao thừa Tết Nguyên đán",
      "kind": "tet",
      "industries": [
        "offerings",
        "F&B"
      ],
      "lead_days": 7,
      "weekday": "Friday",
      "campaign_start": "2027-01-29"
    },
    {
      "date": "2027-02-06",
      "name": "Lunar New Year (Tết 2027)",
      "name_vi": "Tết Nguyên đán 2027",
      "kind": "tet",
      "industries": [
        "gift baskets",
        "F&B",
        "fashion",
        "travel"
      ],
      "lead_days": 45,
      "note": "Most marketplaces slow down deliveries from about 7 days before Tết",
      "weekday": "Saturday",
      "campaign_start": "2026-12-23"
    },
    {
      "date": "2027-12-03",
      "name": "Online Friday (Vietnam Online Shopping Day)",
      "name_vi": "Ngày mua sắm trực tuyến Việt Nam – Online Friday",
      "kind": "national_sale",
      "industries": [
        "all marketplaces",
        "Vietnamese brands"
      ],
      "lead_days": 21,
      "estimated": true,
      "note": "Date announced by Bộ Công Thương each year; estimate = first Friday of December",
      "weekday": "Friday",
      "campaign_start": "2027-11-12"
    }
  ],
  "note": "Marketplace campaign dates (Shopee, Lazada, TikTok Shop, Tiki) follow these anchors but each platform announces its own schedule. Online Friday is announced yearly by Bộ Công Thương."
}

Use cases

Plan a yearly content and promotion calendar
Pre-fill campaign dates in a marketing tool
Import all sale days into a team calendar
Trigger price rules before double days

FAQ

Why are mid-month and payday sales hidden?

They repeat every month; add all=1 or kinds=mid_month,payday to include them.

Are lunar dates correct for any year?

Yes, they are computed with the Vietnamese lunar calendar (UTC+7), valid 1800–2199.

Is the Online Friday date official?

Only for announced years; other years are estimated and flagged.

Related APIs

{✓}

Vietnam sale calendar API

Parameters

Example

Response

Use cases

FAQ

Related APIs

JSON Validator

JSON Formatter

CSV to JSON