Turkey Business Calendar API

Overview

The most comprehensive Turkish business calendar API. Provides official public holidays, business day verification, and BIST (Borsa Istanbul) trading day calendars. Bilingual support (Turkish & English) via ?lang=tr or ?lang=en.

Authentication

Subscribe to a plan and include your RapidAPI key in the X-RapidAPI-Key header.

Endpoints

GET /v1/calendar/holidays/{year}

Returns all official Turkish holidays for the specified year (2000-2100).

GET /v1/calendar/holidays/2026?lang=en

GET /v1/calendar/is-business-day?date=YYYY-MM-DD

Checks whether a date is a business day in Turkey. Returns day of week, weekend status, holiday name.

GET /v1/calendar/is-business-day?date=2026-04-13&lang=tr

Response:

{
  "date": "2026-04-13",
  "day_of_week": "Pazartesi",
  "is_weekend": false,
  "is_holiday": false,
  "is_business_day": true,
  "holiday_name": null
}

GET /v1/calendar/business-days?start=...&end=...

Lists all business days between two dates. Max range: 1 year.

GET /v1/calendar/next-business-day?date=...&n=5

Calculates N business days from a reference date. Essential for delivery estimates and payment due dates.

GET /v1/calendar/bist-trading-days/{year}

Returns all Borsa Istanbul trading days for a given year. Excludes weekends and all public holidays.

Holiday Coverage

Fixed Holidays

Date	Holiday (TR)	Holiday (EN)
Jan 1	Yilbasi	New Year's Day
Apr 23	Ulusal Egemenlik ve Cocuk Bayrami	National Sovereignty and Children's Day
May 1	Emek ve Dayanisma Gunu	Labor and Solidarity Day
May 19	Ataturk'u Anma Genclik Bayrami	Commemoration of Ataturk, Youth Day
Jul 15	Demokrasi ve Milli Birlik Gunu	Democracy and National Unity Day
Aug 30	Zafer Bayrami	Victory Day
Oct 29	Cumhuriyet Bayrami	Republic Day

Islamic Holidays (Diyanet-verified, 2024-2030)

Ramazan Bayrami (Eid al-Fitr) - 3 days
Kurban Bayrami (Eid al-Adha) - 4 days

Use Cases

Payroll and HR systems
Invoice due date calculation
Logistics delivery estimates
BIST algorithmic trading
Accounting software
Payment processing scheduling

Support

support@turkapi.tr | https://turkapi.tr