GET/v1/isholiday

Get all holidays that fall on a given date.

Returns all holidays that fall on a given date, optionally restricted to one country. Requires a `date`. For a full year's calendar use /v2/holidays.

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/isholiday",
  query: {
    "date": "example"
  }
});

console.log(output);

Query parameters

daterequired

string

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

country

string

Country name or ISO 3166-2 country code (preferred). If not specified, holidays from all countries are returned.