Working days

FREEMIUM
By JoursOuvres | Updated 15 days ago | Events
Popularity

9.8 / 10

Latency

79ms

Service Level

100%

Health Check

100%

README

Supported countries & preset configurations

https://api.workingdays.org/api-countries

Creating a custom configuration

By default, the working days API works with the following default parameters:

  • public holidays: national public holidays
  • weekend days: Saturday/Sunday (except for Israel : Friday/Saturday)
  • work hours: Morning : 08:00 -> 12:00 and Afternoon: 14:00 -> 18:00
  • wages: 20 $ / hour
  • overtime, custom dates, custom rules : none

But all calendars can be fully customized.
Suppose we want to customize our calendar for Australia:

  • From the setup screen, define your weekend days one by one and define your own default week time schedule (1 to 4 weeks templates are supported). It is your own default definition of a regular week (working hours morning and afternoon for each day of the week):

  • Choose your public holidays one by one, or by selecting one of our preset configurations:

  • Define one or several custom periodic rules: for instance “every second Monday of the month is closed” or “every Tuesday of January” has specific working hours that overloads your default week time schedule:

  • Add some specific “custom dates” (full day or half day, typically days off). If a custom date is a working day, you can define its working hours, morning and afternoon, overloading your default week time schedule,

  • Now our calendar is fully configured, let’s copy the profile ID (6 characters), we will send it as the API parameter profile_id:

Pricing / Quota consumption

The consumption is not based on the number of requests sent but on the number of days analysed.
For instance “100,000 days/mo” means you can analyse up to a total of 100 000 days in a month (any country, any number of requests).

  • When you query the endpoint analyse with the parameters start_date=2019-01-01&end_date=2019-12-31, it will take off 365 days of your monthly quota because they are 365 days in the year 2019.
  • When you query the endpoint add_working_days with the parameters country_code=FR&start_date=2020-01-01&increment=100, it will take off 147 days of your monthly quota because the resulting period is 147 days long.
  • When you query the endpoint get_info_day, it will remove 1 day from your monthly quota
  • When you query the endpoint add_working_hours, it will remove 1 day for every 8 hours added/removed from your monthly quota (with a minimum of 1 day)
Followers: 20
Resources:
Product Website Terms of use
API Creator:
Rapid account: Jours Ouvres
JoursOuvres
joursouvres
Log In to Rate API
Rating: 4.8 - Votes: 4