BMT-Holiday API: The Most Comprehensive Holiday Data You'll Need For Any Application

Ankit Arora — Tue, 23 Jun 2026 17:47:29 +0000

🎯 The Problem

Let's face it, most holiday APIs are incomplete, expensive, or just plain unreliable. Whether you're building a global scheduling app, planning international content, or creating a travel platform, inaccurate holiday data can break your user experience.

The market is flooded with options:

Holiday API (holidayapi.com): Charges for fresh data and limits free plans
Nager.Date: Only covers 100+ countries—missing nearly 50 countries that BMT-Holiday supports
Abstract API: Has good reviews but limited historical data access
Time and Date: Complex implementation with minimal localization support
API-Ninjas: Covers 230 countries but lacks automatic detection

Meanwhile, BMT-Holiday API gives you 150+ countries, automatic country detection, and localization—all in a single fast and efficient API.

🚀 BMT-Holiday

1️⃣ Automatic Country Detection

Most APIs require you to hardcode country codes. BMT-Holiday intelligently detects the user's location automatically—perfect for mobile apps, global websites, and multi-region platforms.

// With BMT-Holiday, country is OPTIONAL!
GET https://api-bmtdaily.koyeb.app/holidays?date=2026-12-25
// Auto-detects country and returns relevant holidays

2️⃣ Full Holiday Information, Not Just Names

Other APIs give you a holiday name and date. BMT-Holiday provides comprehensive data:

{
  "success": true,
  "user": {
    "is_holiday": true,
    "holiday_name": "Christmas Day",
    "country": "US",
    "details": {
      "type": "Public Holiday",
      "regions": ["All"],
      "observed_by": ["Federal", "State"]
    }
  }
}

3️⃣ Multiple Endpoints for Every Use Case

Endpoint	Purpose	What Others Offer
Quick Holiday Check	Instant yes/no check	Limited to single date
Upcoming Holidays	Plan ahead with details	Basic list only
Worldwide Holidays	Global view on any date	Usually missing
Year/Month/Range	Flexible timeframes	Rigid year-only queries
Compare Countries	Side-by-side holiday comparison	Non-existent!
Search Holidays	Find any holiday by name	Basic filtering only
Regions API	Region-specific holidays	Rarely supported

Bonus: The Refresh Cache endpoint ensures you always have the latest data without waiting for updates.

🔥 Features That Make Developers Choose BMT-Holiday

🌐 Localization Built-In

No more manually mapping country codes to display names. BMT-Holiday localizes holiday names and descriptions automatically based on the user's region.

⚡ Fast Response Times

With intelligent caching and optimized endpoints, BMT-Holiday delivers sub-100ms responses—critical for real-time applications.

📊 Statistical Insights

Need to know how many holidays are coming up? The stats=true parameter gives you instant analytics:

Total holidays in the period
Public vs. regional breakdown
Upcoming holiday counts

🔍 Case-Insensitive Search

Search for "Christmas" or "christmas"—BMT-Holiday finds it. Others? Not so much.

📋 Quick Comparison Table

Feature	BMT-Holiday	Holiday API	Nager.Date	Abstract API
Countries Supported	150+	230+	100+	200+
Auto Country Detection	✅	❌	❌	❌
Localization	✅	Limited	❌	❌
Compare Countries	✅	❌	❌	❌
Search Holidays	✅	Limited	❌	Limited
Region-Specific	✅	❌	✅	❌
Year/Month/Range	✅	✅	✅	Limited
Statistics	✅	❌	❌	❌
Cache Refresh	✅	❌	❌	❌
Health Check	✅	❌	❌	Limited

💻 Example Usage

Check if Today is a Holiday in India

const response = await fetch('https://api-bmtdaily.koyeb.app/holidays/check?country=IN&date=2026-06-23');
const data = await response.json();
console.log(data.is_holiday ? '🎉 Holiday!' : '📅 Working day');

Get All Upcoming Holidays in the US

const response = await fetch('https://api-bmtdaily.koyeb.app/holidays/upcoming?country=US&limit=20&details=true');
const data = await response.json();
data.holidays.forEach(h => console.log(`${h.date}: ${h.name}`));

Compare Holidays Between Two Countries

const response = await fetch('https://api-bmtdaily.koyeb.app/holidays/compare?country=IN&compare_country=US&date=2026-06-23');
const data = await response.json();
console.log(data.comparison); // Full side-by-side comparison

🏆 What Other APIs Can't Do

Automatic Detection: BMT-Holiday knows where your users are—others don't.
Compare Mode: Plan team meetings across time zones with country comparison.
Regional Precision: Get holidays specific to states, provinces, or regions.
Search Intelligence: Find any holiday even if you don't know the exact name.
Real-Time Updates: Refresh cache instantly when data changes.

🚀 Production-Ready Features

Health Check Endpoint

Monitor API status in real-time:

GET https://api-bmtdaily.koyeb.app/health

Tested & Verified

All endpoints include built-in Postman tests and validation:

Status code verification
Response structure validation
Data integrity checks

Developer-Friendly

Detailed, predictable JSON responses
Comprehensive error handling
Detailed documentation
Postman collection ready

Features

✅ Automatic country detection (unique keyword phrase)
✅ 150+ countries (more than Nager.Date)
✅ Compare countries (unique feature no competitor offers)
✅ Built-in localization (developer-friendly)
✅ Cache refresh (enterprise-ready)
✅ Free tier (accessible to all)

Start building with BMT-Holiday.

🔗 Resources

Website: https://bmt-holidays.netlify.app/
RapidAPI: https://rapidapi.com/05.ankitarora/api/bmt-holidays/playground
GitHub: bmt-holidays

Postman schema

{
  "info": {
    "name": "🌍 BMT-Holiday API",
    "description": "Comprehensive BMT-Holiday API with 150+ countries support. Includes automatic country detection with localization.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "item": [
    {
      "name": "Get Holidays (Full Info)",
      "event": [
        {
          "listen": "test",
          "script": {
            "exec": [
              "pm.test(\"Status code is 200\", function() {",
              "    pm.response.to.have.status(200);",
              "});",
              "pm.test(\"Response has success flag\", function() {",
              "    var jsonData = pm.response.json();",
              "    pm.expect(jsonData).to.have.property('success');",
              "    pm.expect(jsonData.success).to.eql(true);",
              "});",
              "pm.test(\"Response has holiday data\", function() {",
              "    var jsonData = pm.response.json();",
              "    pm.expect(jsonData).to.have.property('user');",
              "    pm.expect(jsonData.user).to.have.property('is_holiday');",
              "});"
            ],
            "type": "text/javascript"
          }
        }
      ],
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "https://api-bmtdaily.koyeb.app/holidays?country={{country}}&date={{date}}&stats=true&upcoming=true&limit=20",
          "protocol": "https",
          "host": ["api-bmtdaily", "koyeb", "app"],
          "path": ["holidays"],
          "query": [
            {
              "key": "country",
              "value": "{{country}}",
              "description": "ISO country code (auto-detected if omitted)"
            },
            {
              "key": "date",
              "value": "{{date}}",
              "description": "Date in YYYY-MM-DD format"
            },
            {
              "key": "stats",
              "value": "true",
              "description": "Include statistics"
            },
            {
              "key": "upcoming",
              "value": "true",
              "description": "Include upcoming holidays"
            },
            {
              "key": "limit",
              "value": "20",
              "description": "Number of upcoming holidays"
            }
          ]
        }
      },
      "response": []
    },
    {
      "name": "Quick Holiday Check",
      "event": [
        {
          "listen": "test",
          "script": {
            "exec": [
              "pm.test(\"Status code is 200\", function() {",
              "    pm.response.to.have.status(200);",
              "});",
              "pm.test(\"Response has holiday info\", function() {",
              "    var jsonData = pm.response.json();",
              "    pm.expect(jsonData).to.have.property('is_holiday');",
              "    pm.expect(jsonData).to.have.property('country');",
              "});"
            ],
            "type": "text/javascript"
          }
        }
      ],
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "https://api-bmtdaily.koyeb.app/holidays/check?country={{country}}&date={{date}}",
          "protocol": "https",
          "host": ["api-bmtdaily", "koyeb", "app"],
          "path": ["holidays", "check"],
          "query": [
            {
              "key": "country",
              "value": "{{country}}",
              "description": "ISO country code"
            },
            {
              "key": "date",
              "value": "{{date}}",
              "description": "Date in YYYY-MM-DD format"
            }
          ]
        }
      },
      "response": []
    },
    {
      "name": "Upcoming Holidays",
      "event": [
        {
          "listen": "test",
          "script": {
            "exec": [
              "pm.test(\"Status code is 200\", function() {",
              "    pm.response.to.have.status(200);",
              "});",
              "pm.test(\"Response has upcoming holidays\", function() {",
              "    var jsonData = pm.response.json();",
              "    pm.expect(jsonData).to.have.property('holidays');",
              "});"
            ],
            "type": "text/javascript"
          }
        }
      ],
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "https://api-bmtdaily.koyeb.app/holidays/upcoming?country={{country}}&limit={{limit}}&date={{date}}&details=true",
          "protocol": "https",
          "host": ["api-bmtdaily", "koyeb", "app"],
          "path": ["holidays", "upcoming"],
          "query": [
            {
              "key": "country",
              "value": "{{country}}",
              "description": "ISO country code"
            },
            {
              "key": "limit",
              "value": "{{limit}}",
              "description": "Number of holidays to return"
            },
            {
              "key": "date",
              "value": "{{date}}",
              "description": "Starting date"
            },
            {
              "key": "details",
              "value": "true",
              "description": "Include full details"
            }
          ]
        }
      },
      "response": []
    },
    {
      "name": "Worldwide Holidays",
      "event": [
        {
          "listen": "test",
          "script": {
            "exec": [
              "pm.test(\"Status code is 200\", function() {",
              "    pm.response.to.have.status(200);",
              "});",
              "pm.test(\"Response has worldwide data\", function() {",
              "    var jsonData = pm.response.json();",
              "    pm.expect(jsonData).to.have.property('total_holidays');",
              "    pm.expect(jsonData).to.have.property('countries_with_holidays');",
              "});"
            ],
            "type": "text/javascript"
          }
        }
      ],
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "https://api-bmtdaily.koyeb.app/holidays/worldwide?date={{date}}&limit={{worldwideLimit}}",
          "protocol": "https",
          "host": ["api-bmtdaily", "koyeb", "app"],
          "path": ["holidays", "worldwide"],
          "query": [
            {
              "key": "date",
              "value": "{{date}}",
              "description": "Date to check"
            },
            {
              "key": "limit",
              "value": "{{worldwideLimit}}",
              "description": "Max countries to include"
            }
          ]
        }
      },
      "response": []
    },
    {
      "name": "Get Year Holidays",
      "event": [
        {
          "listen": "test",
          "script": {
            "exec": [
              "pm.test(\"Status code is 200\", function() {",
              "    pm.response.to.have.status(200);",
              "});",
              "pm.test(\"Response has year data\", function() {",
              "    var jsonData = pm.response.json();",
              "    pm.expect(jsonData).to.have.property('total_holidays');",
              "});"
            ],
            "type": "text/javascript"
          }
        }
      ],
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "https://api-bmtdaily.koyeb.app/holidays/year/{{year}}?country={{country}}&details=true",
          "protocol": "https",
          "host": ["api-bmtdaily", "koyeb", "app"],
          "path": ["holidays", "year", "{{year}}"],
          "query": [
            {
              "key": "country",
              "value": "{{country}}",
              "description": "ISO country code"
            },
            {
              "key": "details",
              "value": "true",
              "description": "Include full details"
            }
          ]
        }
      },
      "response": []
    },
    {
      "name": "Get Month Holidays",
      "event": [
        {
          "listen": "test",
          "script": {
            "exec": [
              "pm.test(\"Status code is 200\", function() {",
              "    pm.response.to.have.status(200);",
              "});",
              "pm.test(\"Response has month data\", function() {",
              "    var jsonData = pm.response.json();",
              "    pm.expect(jsonData).to.have.property('total_holidays');",
              "    pm.expect(jsonData).to.have.property('month');",
              "});"
            ],
            "type": "text/javascript"
          }
        }
      ],
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "https://api-bmtdaily.koyeb.app/holidays/month?country={{country}}&year={{year}}&month={{month}}",
          "protocol": "https",
          "host": ["api-bmtdaily", "koyeb", "app"],
          "path": ["holidays", "month"],
          "query": [
            {
              "key": "country",
              "value": "{{country}}",
              "description": "ISO country code"
            },
            {
              "key": "year",
              "value": "{{year}}",
              "description": "Year"
            },
            {
              "key": "month",
              "value": "{{month}}",
              "description": "Month (1-12)"
            }
          ]
        }
      },
      "response": []
    },
    {
      "name": "Get Holidays in Range",
      "event": [
        {
          "listen": "test",
          "script": {
            "exec": [
              "pm.test(\"Status code is 200\", function() {",
              "    pm.response.to.have.status(200);",
              "});",
              "pm.test(\"Response has range data\", function() {",
              "    var jsonData = pm.response.json();",
              "    pm.expect(jsonData).to.have.property('total_holidays');",
              "    pm.expect(jsonData).to.have.property('range');",
              "});"
            ],
            "type": "text/javascript"
          }
        }
      ],
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "https://api-bmtdaily.koyeb.app/holidays/range?country={{country}}&from={{fromDate}}&to={{toDate}}",
          "protocol": "https",
          "host": ["api-bmtdaily", "koyeb", "app"],
          "path": ["holidays", "range"],
          "query": [
            {
              "key": "country",
              "value": "{{country}}",
              "description": "ISO country code"
            },
            {
              "key": "from",
              "value": "{{fromDate}}",
              "description": "Start date (YYYY-MM-DD)"
            },
            {
              "key": "to",
              "value": "{{toDate}}",
              "description": "End date (YYYY-MM-DD)"
            }
          ]
        }
      },
      "response": []
    },
    {
      "name": "Compare Countries",
      "event": [
        {
          "listen": "test",
          "script": {
            "exec": [
              "pm.test(\"Status code is 200\", function() {",
              "    pm.response.to.have.status(200);",
              "});",
              "pm.test(\"Response has comparison data\", function() {",
              "    var jsonData = pm.response.json();",
              "    pm.expect(jsonData).to.have.property('comparison');",
              "    pm.expect(jsonData.comparison).to.have.property('country1');",
              "    pm.expect(jsonData.comparison).to.have.property('country2');",
              "});"
            ],
            "type": "text/javascript"
          }
        }
      ],
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "https://api-bmtdaily.koyeb.app/holidays/compare?country={{country}}&compare_country={{compareCountry}}&date={{date}}",
          "protocol": "https",
          "host": ["api-bmtdaily", "koyeb", "app"],
          "path": ["holidays", "compare"],
          "query": [
            {
              "key": "country",
              "value": "{{country}}",
              "description": "First country"
            },
            {
              "key": "compare_country",
              "value": "{{compareCountry}}",
              "description": "Second country"
            },
            {
              "key": "date",
              "value": "{{date}}",
              "description": "Date to compare"
            }
          ]
        }
      },
      "response": []
    },
    {
      "name": "Search Holidays",
      "event": [
        {
          "listen": "test",
          "script": {
            "exec": [
              "pm.test(\"Status code is 200\", function() {",
              "    pm.response.to.have.status(200);",
              "});",
              "pm.test(\"Response has search results\", function() {",
              "    var jsonData = pm.response.json();",
              "    pm.expect(jsonData).to.have.property('results');",
              "});"
            ],
            "type": "text/javascript"
          }
        }
      ],
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "https://api-bmtdaily.koyeb.app/holidays/search?q={{searchQuery}}&country={{country}}&year={{year}}&caseSensitive=false",
          "protocol": "https",
          "host": ["api-bmtdaily", "koyeb", "app"],
          "path": ["holidays", "search"],
          "query": [
            {
              "key": "q",
              "value": "{{searchQuery}}",
              "description": "Search term (min 2 chars)"
            },
            {
              "key": "country",
              "value": "{{country}}",
              "description": "ISO country code"
            },
            {
              "key": "year",
              "value": "{{year}}",
              "description": "Year to search"
            },
            {
              "key": "caseSensitive",
              "value": "false",
              "description": "Case sensitive search"
            }
          ]
        }
      },
      "response": []
    },
    {
      "name": "Get Supported Countries",
      "event": [
        {
          "listen": "test",
          "script": {
            "exec": [
              "pm.test(\"Status code is 200\", function() {",
              "    pm.response.to.have.status(200);",
              "});",
              "pm.test(\"Response has countries data\", function() {",
              "    var jsonData = pm.response.json();",
              "    pm.expect(jsonData).to.have.property('countries');",
              "    pm.expect(jsonData).to.have.property('total_countries');",
              "});"
            ],
            "type": "text/javascript"
          }
        }
      ],
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "https://api-bmtdaily.koyeb.app/holidays/countries",
          "protocol": "https",
          "host": ["api-bmtdaily", "koyeb", "app"],
          "path": ["holidays", "countries"]
        }
      },
      "response": []
    },
    {
      "name": "Get Regions",
      "event": [
        {
          "listen": "test",
          "script": {
            "exec": [
              "pm.test(\"Status code is 200\", function() {",
              "    pm.response.to.have.status(200);",
              "});",
              "pm.test(\"Response has regions data\", function() {",
              "    var jsonData = pm.response.json();",
              "    pm.expect(jsonData).to.have.property('regions');",
              "    pm.expect(jsonData).to.have.property('total_regions');",
              "});"
            ],
            "type": "text/javascript"
          }
        }
      ],
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "https://api-bmtdaily.koyeb.app/holidays/regions?country={{country}}&year={{year}}",
          "protocol": "https",
          "host": ["api-bmtdaily", "koyeb", "app"],
          "path": ["holidays", "regions"],
          "query": [
            {
              "key": "country",
              "value": "{{country}}",
              "description": "ISO country code"
            },
            {
              "key": "year",
              "value": "{{year}}",
              "description": "Year"
            }
          ]
        }
      },
      "response": []
    },
    {
      "name": "Refresh Cache",
      "event": [
        {
          "listen": "test",
          "script": {
            "exec": [
              "pm.test(\"Status code is 200\", function() {",
              "    pm.response.to.have.status(200);",
              "});",
              "pm.test(\"Response confirms cache refresh\", function() {",
              "    var jsonData = pm.response.json();",
              "    pm.expect(jsonData).to.have.property('message');",
              "    pm.expect(jsonData.message).to.include('refreshed');",
              "});"
            ],
            "type": "text/javascript"
          }
        }
      ],
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "https://api-bmtdaily.koyeb.app/holidays/refresh?country={{country}}&year={{year}}",
          "protocol": "https",
          "host": ["api-bmtdaily", "koyeb", "app"],
          "path": ["holidays", "refresh"],
          "query": [
            {
              "key": "country",
              "value": "{{country}}",
              "description": "ISO country code"
            },
            {
              "key": "year",
              "value": "{{year}}",
              "description": "Year"
            }
          ]
        }
      },
      "response": []
    },
    {
      "name": "Health Check",
      "event": [
        {
          "listen": "test",
          "script": {
            "exec": [
              "pm.test(\"Status code is 200\", function() {",
              "    pm.response.to.have.status(200);",
              "});",
              "pm.test(\"Service is healthy\", function() {",
              "    var jsonData = pm.response.json();",
              "    pm.expect(jsonData).to.have.property('status');",
              "    pm.expect(jsonData.status).to.eql('healthy');",
              "});"
            ],
            "type": "text/javascript"
          }
        }
      ],
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "https://api-bmtdaily.koyeb.app/health",
          "protocol": "https",
          "host": ["api-bmtdaily", "koyeb", "app"],
          "path": ["health"]
        }
      },
      "response": []
    }
  ],
  "variable": [
    {
      "key": "country",
      "value": "IN",
      "type": "string"
    },
    {
      "key": "date",
      "value": "2026-06-21",
      "type": "string"
    },
    {
      "key": "year",
      "value": "2026",
      "type": "string"
    },
    {
      "key": "month",
      "value": "7",
      "type": "string"
    },
    {
      "key": "limit",
      "value": "10",
      "type": "string"
    },
    {
      "key": "worldwideLimit",
      "value": "10",
      "type": "string"
    },
    {
      "key": "compareCountry",
      "value": "US",
      "type": "string"
    },
    {
      "key": "searchQuery",
      "value": "Columbus",
      "type": "string"
    },
    {
      "key": "fromDate",
      "value": "2026-06-01",
      "type": "string"
    },
    {
      "key": "toDate",
      "value": "2026-06-30",
      "type": "string"
    }
  ]
}

BMT-Holiday API: The Most Comprehensive Holiday Data Solution | 150+ Countries | Automatic Detection | Built-in Localization

DEV Community: Ankit Arora