← Intelligence Mashups

Festival & Event Finder

GET /mashup/festival/finder

Discover upcoming festivals and events: combines public holidays, shopping events, weather forecasts, and country data for any country. Filter by how far ahead to look.

Parameters

country required

Country code

months optional

Months ahead to search (default 3)

Example Requests

Basic usage
curl "https://nordapi.ee/api/v1/mashup/festival/finder?country=EE&months=6"

Live Response 

{
  "country": "EE",
  "country_name": "Estonia",
  "generated_at": "2026-04-05T19:30:47.165476Z",
  "months_ahead": 6,
  "public_holidays": [
    {
      "date": "2026-04-05",
      "name": "Easter Sunday",
      "type": "Public"
    },
    {
      "date": "2026-05-01",
      "name": "Spring Day",
      "type": "Public"
    },
    {
      "date": "2026-05-24",
      "name": "Pentecost",
      "type": "Public"
    },
    {
      "date": "2026-06-23",
      "name": "Victory Day",
      "type": "Public"
    },
    {
      "date": "2026-06-24",
      "name": "Midsummer Day",
      "type": "Public"
    },
    {
      "date": "2026-08-20",
      "name": "Day of Restoration of Independence",
      "type": "Public"
    }
  ],
  "shopping_events": [
    {
      "category": "seasonal",
      "date": "2026-04-03",
      "name": "Easter Sales"
    },
    {
      "category": "seasonal",
      "date": "2026-06-26",
      "name": "Midsummer Sales"
    },
    {
      "category": "ecommerce",
      "date": "2026-07-15",
      "name": "Amazon Prime Day"
    }
  ],
  "success": true,
  "weather_forecast": null
}
← Back to Intelligence Mashups