Validate time-off request | Deel

import requests
url = "https://api.letsdeel.com/rest/v2/time_offs/validate"
payload = { "data": {
        "end_date": "2025-05-15",
        "start_date": "2025-05-13",
        "recipient_profile_id": "ec3aeb49-0fed-41d0-87c6-86ec22b750b3",
        "dates": [
            {
                "date": "2025-05-13",
                "day_type": "FULL_DAY"
            },
            {
                "date": "2025-05-14",
                "day_type": "HALF_DAY"
            },
            {
                "date": "2025-05-15",
                "day_type": "HALF_DAY"
            }
        ],
        "is_paid": True,
        "description": "No description",
        "time_off_type_id": "a2c4a920-e186-4a17-8397-e5706eaf4ee4"
    } }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "data": {
    "is_valid": true,
    "dates": [
      {
        "date": "2025-05-13",
        "type": "WORKING_DAY",
        "hours": [
          4,
          8
        ],
        "amount": 8,
        "time_off_percentage": 1
      },
      {
        "date": "2025-05-14",
        "type": "WORKING_DAY",
        "hours": [
          4,
          8
        ],
        "amount": 8,
        "time_off_percentage": 1
      },
      {
        "date": "2025-05-15",
        "type": "WORKING_DAY",
        "hours": [
          4,
          8
        ],
        "amount": 8,
        "time_off_percentage": 1
      }
    ],
    "amount": 24,
    "new_end_date": "2025-05-15",
    "new_start_date": "2025-05-13",
    "remaining_balance": -8.333333333333334,
    "require_attachment": false,
    "require_description": false,
    "country_specific_validation_results": [
      {
        "validation_type": "BRAZIL_MAX_REQUESTS",
        "data": {
          "ranges": [
            {
              "start_day": 1,
              "end_day": 3
            },
            {
              "start_day": 15,
              "end_day": 19
            }
          ],
          "max_requests": 30
        },
        "is_valid": true,
        "description": "This policy doesn’t allow more than 3 requests to be submitted in a single period"
      }
    ],
    "country_specific_validation_results_next_tracking_period": [
      {
        "validation_type": "BRAZIL_MAX_REQUESTS",
        "data": {
          "ranges": [
            {
              "start_day": 1,
              "end_day": 3
            },
            {
              "start_day": 15,
              "end_day": 19
            }
          ],
          "max_requests": 30
        },
        "is_valid": true,
        "description": "This policy doesn’t allow more than 3 requests to be submitted in a single period"
      }
    ]
  }
}

Validate time-off requests and updates 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/

Request

Time off request data

dataobjectOptional

Time off request data

Response

Time off request validation result

dataobject

Time off request validation result

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

Authentication

Authentication

Request

Response

Errors

Authentication