DEV Community: Ankit Arora

Scaleable Multifaceted File System Search Architecture

Ankit Arora — Wed, 01 Jul 2026 05:38:41 +0000

To achieve an efficient "fast file lookup search, then deep content graph indexing," the best approach is a layered architecture including knowledge graph construction:

Layer 1 (Instant Lookup): Uses native OS commands to find files by name/metadata in milliseconds.
Layer 2 (Content Extraction): Parses the found files to extract plain text.
Layer 3 (Knowledge Memory): Stores extracted text as vectors and graph relationships, with built-in TTL (Time-To-Live) for automatic expiration.

Complete technical blueprint and architecture design

1. Fast File Lookup (Using OS Native Commands)

To find files instantly without scanning the entire hard drive, you must tap into the OS's pre-built indexes. Do not use os.walk() for the initial lookup.

OS	Command / SDK	How it works
Windows	Everything SDK / `es.exe`	Accesses the USN Journal and MFT (Master File Table). Searches are near-instantaneous (<100ms for millions of files).
macOS	`mdfind`	Uses the Spotlight metadata index. Run `mdfind -name "keyword"` for filenames, or `mdfind "kMDItemContentType == 'pdf'"` for types.
Linux	`plocate` / `mlocate`	Uses a pre-built database updated by `updatedb`. `plocate` is extremely fast and uses minimal I/O.

Python Implementation Snippet:

import subprocess
import platform

def os_file_lookup(query, file_type=None):
    system = platform.system()
    if system == "Windows":
        # Assuming Everything is installed
        cmd = ["es.exe", "-n", "100", query] 
    elif system == "Darwin": # macOS
        cmd = ["mdfind", "-name", query]
    else: # Linux
        cmd = ["plocate", query]

    result = subprocess.run(cmd, capture_output=True, text=True)
    return result.stdout.splitlines()

2. Content Extraction (Parsing PDF, Word, Excel, etc.)

Once you have the file paths from Layer 1, you pass them to an extraction engine. For a unified interface, use these Python libraries:

all2txt or doc-master: Provides a single parse(file_path) function that handles .docx, .xlsx, .pptx, .pdf, .odt, .epub, and .pages. It automatically chooses the right parser behind the scenes.
fscan: A multi-threaded Python search tool. You can borrow its extractor logic for speed.
For more improved performance in C++ *: Use *libpoppler (PDF), libxml2 (DOCX/XLSX are just ZIPs of XML), and xlsxioread (Excel).

3. Knowledge Graph + Vector Memory (With TTL)

To store this as "memory" and remove it after disuse or max capacity, you need a database that supports Graph relationships, Vector embeddings, and TTL (Time-To-Live) indices.

Tool	Why it fits your requirement
Grafeo (with LlamaIndex)	An embedded graph database (single `.db` file). It natively supports Vector Search (for semantic context) and GQL (Graph Query Language). Perfect for a single installable software.
Cognee	Specifically built as an "AI Memory" engine. It automates the extraction of entities and relationships from your extracted text, builds a graph, and automatically prunes (deletes) old data based on usage frequency.
SQLite + sqlite-vec + TTL	A simpler DIY approach: Store chunks of text in SQLite, enable the `sqlite-vec` extension for similarity search, and add a `created_at` column with an index. Run a background scheduler every hour to `DELETE FROM memory WHERE created_at < datetime('now', '-7 days')`.

Memory Management (Your "Remove after unused or max increased" requirement):

Use a LRU (Least Recently Used) cache pattern on the graph nodes.
Store a last_accessed timestamp for every entity. When the database exceeds your defined size limit (e.g., 500MB), run a cleanup job that deletes the oldest 20% of nodes.
Alternatively, assign a "Hotness" score. Files opened via the chat interface get a +1 score; if a node's score drops to 0 and 30 days have passed, it is purged.

4. Hybrid Search Workflow (Efficient "Lookup First" Search)

Your system should not search the heavy graph database for every keystroke. Use this flow:

User types a query in the chat interface.
Fast Path: Fire the OS command (mdfind/es.exe) to get filenames matching the query. Display these immediately (under 200ms).
Parallel Deep Path: Simultaneously, send the query to the Knowledge Graph (Vector + Graph search). This takes a bit longer (1-3 seconds).
Aggregation: Show the user: "Found 15 files (OS lookup). Here are the top 3 knowledge contexts extracted from them (AI lookup)."

5. Suggested System Architecture Diagram

flowchart TD
    UI[User Chat / Editor Interface] --> Router{Query Router};

    Router -->|"Filename/Path Query"| OS_Layer[OS Lookup Layer];
    OS_Layer --> Win[Windows: Everything SDK];
    OS_Layer --> Mac[macOS: mdfind];
    OS_Layer --> Lin[Linux: plocate];
    OS_Layer -->|"Paths found"| Extractor[Content Extractor];

    Router -->|"Semantic / Context Query"| Graph_DB[Knowledge Graph Memory];
    Graph_DB --> Vec[Vector Search for Context];
    Graph_DB --> Rel[Graph Traversal for Relationships];

    Extractor --> Chunker[Text Chunker + Embedder];
    Chunker --> Graph_DB;

    subgraph Memory_Management[Automated Memory Pruning]
        TTL[TTL Scheduler] -->|"Delete old/unused nodes"| Graph_DB;
        Size_Monitor[Size Monitor] -->|"If > 500MB, purge oldest"| Graph_DB;
    end

    OS_Layer --> Aggregator[Result Aggregator];
    Graph_DB --> Aggregator;
    Aggregator --> UI;

6. Roadmap for the Installable Text Editor + Chat Solution

Since you want to eventually build this into a downloadable app in (C++ or Python), here is the recommended tech stack:

Backend Core (Python): Use FastAPI or Starlette to wrap your search and graph logic into a local REST API or WebSocket server.
Frontend UI (Cross-platform): Use Tauri (Rust + HTML/JS) or Electron for the text editor with a chat sidebar. Tauri is lighter, but Electron is easier to integrate Python via child_process.
Packaging: Use PyInstaller (for Python) or CPack (for C++) to bundle the Everything SDK (Windows DLLs) and the database into a single .exe / .dmg / .deb.

Why choose this approach?

Speed: OS commands give you file results in < 100ms, which feels "instant" to users.
Intelligence: The Graph DB provides "contextual memory" (e.g., finding an Excel number mentioned in a PDF).
Self-maintaining: The TTL and size monitors ensure the software won't bloat your user's hard drive, automatically removing memory that is no longer relevant.

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