← World Data

Check Shopping Holiday

GET /shopping/check

Check whether today is a shopping holiday or sale event in a specific country. Returns a boolean result along with event details if active. Useful for triggering automated sale banners, sending push notifications about ongoing deals, and adjusting pricing strategies during major shopping events like Black Friday.

Parameters

country required

Country

Example Requests

Basic usage
curl "https://nordapi.ee/api/v1/shopping/check?country=US"
Check US shopping holidays today
curl "https://nordapi.ee/api/v1/shopping/check?country=US"
Check Chinese shopping holidays today
curl "https://nordapi.ee/api/v1/shopping/check?country=CN"
Check UK shopping holidays today
curl "https://nordapi.ee/api/v1/shopping/check?country=GB"

Live Response 

{
  "active_events": [
    {
      "category": "seasonal",
      "countries": [
        "GLOBAL"
      ],
      "date": "2026-04-03",
      "days_until": 0,
      "description": "Spring sales event. Fashion, home & garden, chocolate/confectionery.",
      "duration_days": 4,
      "end_date": "2026-04-06",
      "id": "easter_sales",
      "impact": "high",
      "is_active": true,
      "name": "Easter Sales",
      "status": "active_now"
    }
  ],
  "country": "US",
  "date": "2026-04-05",
  "days_until_next": -2,
  "is_shopping_holiday": true,
  "next_event": {
    "category": "seasonal",
    "countries": [
      "GLOBAL"
    ],
    "date": "2026-04-03",
    "days_until": 0,
    "description": "Spring sales event. Fashion, home & garden, chocolate/confectionery.",
    "duration_days": 4,
    "end_date": "2026-04-06",
    "id": "easter_sales",
    "impact": "high",
    "is_active": true,
    "name": "Easter Sales",
    "status": "active_now"
  },
  "success": true
}
← Back to World Data