Deel: Get Work Schedule and Holidays — 200 response body — data item holidays item
Get Work Schedule and Holidays: 200 response body, field data / item / holidays / item. Complete fields and constraints for contract 2026-10-27.
API reference · Contract 2026-10-27
SDK schema: Get Work Schedule and Holidays — 200 response body — data item holidays item
| Field | Type | Presence | Description and constraints |
|---|---|---|---|
$ | object | Root | |
country | string | Optional | The ISO 3166-1 alpha-2 country code. Maximum length: 2 Minimum length: 2 Pattern: ^[A-Z]{2}$ |
created_by_profile_id | JSON | Optional | |
created_by_profile_id (anyOf 1) | JSON | Alternative | |
created_by_profile_id (anyOf 1) (anyOf 1) | number | Alternative | HRIS profile id of the creator of the holiday Format: double |
created_by_profile_id (anyOf 1) (anyOf 2) | string | Alternative | Pattern: ^-?[0-9]+(?:.[0-9]+)?(?:[eE][+-]?[0-9]+)?$ |
created_by_profile_id (anyOf 2) | null | Alternative | HRIS profile id of the creator of the holiday Format: double |
date | string | Required within parent | Date of the holiday Format: date-time |
description | JSON | Required within parent | |
description (anyOf 1) | string | Alternative | Description of the holiday |
description (anyOf 2) | null | Alternative | Description of the holiday |
formatted_date | string | Required within parent | Formatted ‘YYYY-MM-DD’ date of the holiday Format: date |
is_every_year | boolean | Required within parent | Sets if the holiday is a recurring event |
is_mandatory | boolean | Required within parent | Describes if the holiday is mandatory |
name | string | Required within parent | Name of the holiday |
name_variations | array | Optional | Alternative names or labels used to refer to this holiday |
name_variations[] | string | Each item | |
parsed_date | string | Optional | Parsed date time of the holiday Format: date-time |
source | JSON | Required within parent | Source of creation of the holiday |
source (anyOf 1) | string | Alternative | Source of creation of the holiday Known values: EXTERNAL, DEEL, ORGANIZATION_CUSTOM, ORGANIZATION_OVERRIDE, ORGANIZATION_CONVERT |
source (anyOf 2) | null | Alternative | |
states | array | Optional | List of states where the holiday is celebrated, if empty it is a country holiday |
states[] | string | Each item | |
type | string | Required within parent | Type of the holiday Known values: MANDATORY, OPTIONAL, HIDDEN, HOLIDAY, WORKING_DAY |