Business Days Calculator API
Calculate business days across the GCC with country-specific weekends and holidays. Supports three modes: single date check, counting business days between dates, and adding business days to a start date.
/v1/business-daysTry it out
/v1/business-daysParameters
Code
curl -X GET "https://khaleejiapi.dev/api/v1/business-days?country=AE&from=2025-01-01&to=2025-12-31" \ -H "X-API-Key: your_api_key"Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| country | string | Optional | GCC country code (AE, SA, KW, BH, OM, QA) |
| date | string | Optional | YYYY-MM-DD — check if a single date is a business day |
| from | string | Optional | YYYY-MM-DD — start date for counting or adding modes |
| to | string | Optional | YYYY-MM-DD — end date for counting mode (max 2 years) |
| add | number | Optional | Number of business days to add from 'from' date (1–365) |
| weekend | string | Optional | Override weekend days, e.g. 'fri,sat' or 'sat,sun' |
Calculation Modes
Single Date Check — ?date=2025-06-05
Check if a specific date is a business day. Returns isBusinessDay, isWeekend, isHoliday flags, day of week in English and Arabic, and holiday details if applicable.
Counting Mode — ?from=2025-01-01&to=2025-12-31
Count business days between two dates (max 2-year range). Returns businessDays, totalDays, weekendDays, holidayDays, and lists all holidays in the range.
Adding Mode — ?from=2025-01-01&add=30
Add a specified number of business days (1–365) to a start date. Returns the resulting date after skipping weekends and holidays.
Weekend Configuration
Each GCC country has its own weekend schedule. The UAE switched to Sat–Sun in January 2022, while most other GCC countries observe Fri–Sat. You can override weekends using the weekend parameter.
Rate Limits
| Plan | Requests/Month | Rate Limit |
|---|---|---|
| Free | 1,000 | 10 req/min |
| Starter | 10,000 | 60 req/min |
| Professional | 100,000 | 300 req/min |
| Business | 500,000 | 1,000 req/min |