Get Work Schedule and Holidays | Deel

curl -G https://api.letsdeel.com/rest/v2/time_offs/dailies \
     -H "Authorization: Bearer <token>" \
     -d start_date=2025-01-01 \
     -d end_date=2025-02-01 \
     -d hris_profile_ids=d290f1ee-6c54-4b01-90e6-d701748f0851 \
     -d countries=US

{
  "data": [
    {
      "holidays": [
        {
          "date": "2025-01-01T00:00:00.000Z",
          "name": "New Year's Day",
          "type": "HOLIDAY",
          "source": "EXTERNAL",
          "description": "New Year's Day global holiday",
          "is_mandatory": true,
          "is_every_year": true,
          "formatted_date": "2025-01-01",
          "states": [],
          "country": "US",
          "parsed_date": "2025-01-01T00:00:00.000+00:00",
          "name_variations": [
            "January 1"
          ]
        }
      ],
      "work_schedule": {
        "work_week": {
          "friday": 8,
          "monday": 8,
          "sunday": 0,
          "tuesday": 8,
          "saturday": 0,
          "thursday": 8,
          "wednesday": 8
        },
        "hours_per_day": 8,
        "hris_profile_id": "d290f1ee-6c54-4b01-90e6-d701748f0851"
      },
      "time_off_dailies": [
        {
          "date": "2025-01-01",
          "time_off_daily_type": "HOLIDAY"
        },
        {
          "date": "2025-01-02",
          "time_off_daily_type": "WORKING_DAY"
        },
        {
          "date": "2025-01-03",
          "time_off_daily_type": "WORKING_DAY"
        }
      ]
    }
  ]
}

Given a date range (start date, end date) gets the holidays, work schedule and time off dailies for a list of hrisProfileIds or countries. Token scopes: time-off:read

Authentication

AuthorizationBearer

Authentication

The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authentication will fail.

1 curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \
2   -H 'Authorization: Bearer YOUR-TOKEN-HERE'

Learn more about authentication

## Authentication The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authentication will fail. ```curl curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \ -H 'Authorization: Bearer YOUR-TOKEN-HERE' ``` [Learn more about authentication](/api/authentication)

AuthorizationBearer

Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/

Query parameters

start_datestringOptionalformat: "date"

Start date of non working days date range

end_datestringOptionalformat: "date"

End date of non working days date range

hris_profile_idslist of stringsOptional

HRIS profile ids

countrieslist of stringsOptional

List of countries to be fetched

Response

Successful operation.

datalist of objects

List of holiday and work schedule information grouped by HRIS profile, including holidays within the date range, work schedule details, and daily work status

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

1	curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \
2	-H 'Authorization: Bearer YOUR-TOKEN-HERE'