GET/v1/isbankholiday

Check if a specific date is a bank holiday for a given country.

Checks whether a given date is a bank holiday in a country. Requires `date` and `country`. For a whole year's calendar use /bankholidays.

API Ninjas·$0.001 per call

Example code

// Using @orth/sdk - The simplest way to call APIs
// Install: npm install @orth/sdk
import Orthogonal from "@orth/sdk";

const orthogonal = new Orthogonal({
  apiKey: process.env.ORTHOGONAL_API_KEY,
});

const output = await orthogonal.run({
  api: "api-ninjas",
  path: "/v1/isbankholiday",
  query: {
    "date": "example",
    "country": "example"
  }
});

console.log(output);

Query parameters

daterequired

string

Date in YYYY-MM-DD format (e.g. 2025-12-25).

countryrequired

string

Country name or ISO 3166-2 country code (preferred).