Public Holidays

import { KhaleejiAPI } from '@khaleejiapi/sdk';
 
const client = new KhaleejiAPI({ apiKey: 'your_api_key' });
 
// Get next upcoming holiday
const next = await client.finance.getHolidays({ country: 'AE', mode: 'next' });
console.log(next.holiday.name, `in ${next.holiday.daysUntil} days`);
 
// Check if today is a holiday
const check = await client.finance.getHolidays({ country: 'AE', mode: 'check', date: 'today' });
console.log(check.isHoliday, check.isWeekend, check.isDayOff);
 
// List all holidays with smart metadata
const result = await client.finance.getHolidays({ country: 'AE', year: 2025 });
for (const h of result.holidays) {
  console.log(`${h.date} — ${h.name} (${h.dayOfWeek}, ${h.sector})`);
}

from khaleejiapi import KhaleejiAPI
 
client = KhaleejiAPI('your_api_key')
 
# Check if a specific date is a day off
result = client.finance.get_holidays(country="AE", mode="check", date="2025-12-02")
print(f"Holiday: {result['isHoliday']}, Day off: {result['isDayOff']}")
 
# Get next upcoming holiday
next_h = client.finance.get_holidays(country="SA", mode="next")
print(f"Next: {next_h['holiday']['name']} in {next_h['holiday']['daysUntil']} days")

# Get next holiday
curl -X GET "https://khaleejiapi.dev/api/v1/holidays?country=AE&mode=next" \
  -H "x-api-key: your_api_key"
 
# Check if date is a holiday
curl -X GET "https://khaleejiapi.dev/api/v1/holidays?country=AE&mode=check&date=today" \
  -H "x-api-key: your_api_key"