---
title: "GET /api/calendar/business-day"
method: GET
path: "/api/calendar/business-day"
tags: ["Market Calendar"]
---

# GET /api/calendar/business-day

`GET /api/calendar/business-day`

## Request

- Base URL: `https://api.unirateapi.com`
- URL: `https://api.unirateapi.com/api/calendar/business-day`
- Auth: none declared
- TypeScript: <https://skmtc.dev/unirateapi/apis/unirate-api/docs/api/calendar/business-day/get.ts> (a function with typed inputs; its response is checked against the schema)

Is a date a business day in a country (optionally a subdivision) or on a currency's settlement calendar? Returns the holiday name if any, and the previous/next business days. Respects non-Saturday/Sunday weekends (e.g. Friday-Saturday in Saudi Arabia). Available on the FREE tier. Reference only.

## Query parameters

- `api_key` string, required
- `country` string
- `subdiv` string
- `currency` string
- `date` string
- `format` 'json' | 'xml'
- `callback` string

## Response `200`

Business-day status.

## Other responses

- `400`: Invalid parameters
- `401`: Missing or invalid API key
- `404`: Country or currency not supported
- `429`: Daily request quota exceeded

---

[API](https://skmtc.dev/unirateapi/apis/unirate-api.md) - [All operations](https://skmtc.dev/unirateapi/apis/unirate-api/llms.txt) - [OpenAPI document](https://skmtc.dev/unirateapi/apis/unirate-api/revisions/e5fd92902326?raw)