▣ HR · STANDARD DATA

Working Day Calculator API

Hosted on ApyHub

What it does

The Working Day Calculator API counts the business days between two dates for a country. Send a country code, a start date and an end date, and get back the number of working days with weekends and that country's public holidays already excluded.

It is one GET endpoint with three required parameters: country, such as DE, and start and end dates in YYYY-MM-DD format. The response gives you the full breakdown in a data object: total_days for the calendar days in the range, counting both the start and end date, weekends for the Saturdays and Sundays, holidays for the public holidays that fall on a weekday, and working_days for the Monday to Friday days that remain. For January 2025 in Germany, that is 31 total days, 8 weekend days, 1 holiday and 22 working days.

Common uses include calculating pay periods and prorated salaries in payroll, measuring SLA and support response windows in business days, estimating delivery and lead times, counting leave days in HR tools, and setting deadlines that skip non-working days. Because the holidays come from each country's calendar, you do not have to maintain your own holiday list for every market you operate in.

To see which dates are holidays, not just how many there are, use the Public Holidays API. For more business-day math, try the Business Days Calculator. If your team works across regions, the Convert Timezone and Meeting Planner helps you find times that work for everyone.

You can try it right here in the API playground. Start for free with 5 API calls a day, no card required, and check the working days for your own dates before you commit.

The API is also available through ApyHub MCP, so AI agents can count working days directly when they plan deadlines or schedules.

GET

Count working days between two dates

https://api.eu.apyhub.com/apyhub/count-working-days

QUICKSTART

GUIDE

Quickstart

Count the working days between two dates for a country.

curl -X GET "https://api.eu.apyhub.com/apyhub/count-working-days?country=DE&start=2025-01-01&end=2025-01-31" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with a data object containing holidays, weekends, total_days, and working_days integer fields.

{
  "data": {
    "holidays": 1,
    "weekends": 8,
    "total_days": 31,
    "working_days": 22
  }
}

TRY ITLIVE · 15 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Calculates the number of working days between two dates for a given country. The response returns a data object with the calendar-day breakdown and the resulting working-day count.

Query Parameter(s)

Attribute	Type	Mandatory	Description
country	String	Yes	Country code.
start	String	Yes	Start date in `date` format.
end	String	Yes	End date in `date` format.

Response

Returns a JSON object with a data object field. The data object contains integer counts for holidays, weekends, total_days, and working_days.

Attribute	Type	Mandatory	Description
data	Object	No	Result object containing the working-day breakdown.
data.holidays	Integer	No	Public holidays that fell on a weekday (reduced working day count).
data.weekends	Integer	No	Saturday and Sunday days in the range.
data.total_days	Integer	No	Calendar days between start and end (inclusive).
data.working_days	Integer	No	Mon–Fri days excluding public holidays.

▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.

Similar APIs

Closest matches in the catalog based on this service.

CALLBusiness Days Calculator API.nick creighton CALLPublic Holidays APIApyHub CALLAdvanced Schedule Cron APInick creighton CALLConvert Timezone and Meeting Planner APInick creighton

From the blog

Reads that touch this API.

What Is a Business Day? How to Calculate Business Days in CodeSep 18, 2026 How Many Working Days Are in 2027? By Country and MonthSep 18, 2026 Timezones Dictionary API: Global Timezone Data and Best Alternatives for 2026Jul 9, 2026 Getting Started with APIs: A Beginner’s Guide 2026Sep 17, 2026