Working Days Calculator API
Count working days between two dates and add/subtract business days, skipping weekends and the public holidays of 100+ countries and regions. Custom weekend days.
Authentication & base URL
Subscribe through one of our marketplace listings; your marketplace API key and base URL are shown there. All endpoints return JSON over HTTPS, served from a global edge network (typically 20–150 ms).
Endpoints
GET /v1/business-days
Business days between dates
| Parameter | In | Description | Example |
|---|---|---|---|
start * | query | YYYY-MM-DD | 2026-12-01 |
end * | query | YYYY-MM-DD | 2026-12-31 |
country | query | ISO country (optional) | ES |
state | query | Region (optional) | |
weekend | query | Weekend days 0=Sun..6=Sat | 6,0 |
GET /v1/business-days/add
Add business days
| Parameter | In | Description | Example |
|---|---|---|---|
date * | query | YYYY-MM-DD | 2026-12-23 |
days * | query | Business days (negative to subtract) | 3 |
country | query | ISO country | ES |
Example
GET /v1/business-days?start=2026-12-01&end=2026-12-31&country=ES&state=&weekend=6%2C0
{
"start": "2026-12-01",
"end": "2026-12-31",
"calendarDays": 31,
"businessDays": 21,
"weekendDays": 8,
"holidaysOnWeekdays": [
"2026-12-08",
"2026-12-25"
],
"country": "ES",
"note": "Both start and end dates included."
}Count working days between two dates and add/subtract business days, skipping weekends and the public holidays of 100+ countries and regions. Custom weekend days.
Use cases
Delivery date estimates, SLA and payment due dates, HR and payroll, project planning, legal deadlines.
Why this API
- Fast: runs on a global edge network, typical response well under 1 second.
- Reliable: simple JSON, clear error messages.
- Fair pricing: Free plan 500 requests/month, Pro 25,000 for $4.99, Ultra 150,000 for $14.99.
Pricing
Free plan with 500 calls per month, then Pro (25,000 calls for $4.99/month) and Ultra (150,000 calls for $14.99/month). See all plans.