Submit employee resignation PTO review

POST

/eor/contracts/:contract_id/offboarding/resignations/review-pto

POST

/rest/eor/contracts/:contract_id/offboarding/resignations/review-pto

curl -X POST https://api.letsdeel.com/rest/eor/contracts/5B74FnLM/offboarding/resignations/review-pto \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{}'

{
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "end_date": "2025-01-31T00:00:00.000Z",
    "documents": {
      "supporting": [
        {
          "id": "cmddlk1ghehm54l18gejg198r",
          "name": "Supporting Documentation",
          "type": "pdf",
          "created_at": "2025-07-21T21:07:27.713Z",
          "updated_at": "2025-07-21T21:07:27.713Z",
          "is_additional_supporting_document": false
        }
      ],
      "offboarding": [
        {
          "files": [
            {
              "id": "cmdeh9wzgvihue4r54n2y51p4",
              "name": "Employee Sign Off Documents",
              "type": "pdf",
              "created_at": "2025-07-22T11:55:23.068Z",
              "updated_at": "2025-07-22T11:55:23.068Z"
            }
          ],
          "status": "AWAITING_REVIEW",
          "reviewer_type": "EMPLOYEE",
          "is_employee_notification_required": true,
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "created_at": "2025-07-22T11:55:23.068Z",
          "updated_at": "2025-07-22T11:55:23.068Z",
          "reviewed_at": "2025-07-22T12:30:00.000Z",
          "reviewed_by": "John Doe",
          "reviewer_feedback": "Document needs clarification on section 3",
          "notification_instructions": "<p>Please review and provide feedback on the attached documents.</p>"
        }
      ]
    },
    "created_at": "2025-01-31T00:00:00.000Z",
    "updated_at": "2025-01-31T00:00:00.000Z",
    "contract_id": "5B74FnLM",
    "is_sensitive": false,
    "request_data": {
      "reason": "PERFORMANCE",
      "end_date": "2025-01-31T00:00:00.000Z",
      "reason_detail": "Employee is moving to another country",
      "used_time_off": {
        "time_offs": [
          {
            "unit": "BUSINESS_DAY",
            "policy_type": "Vacation",
            "tracking_periods": [
              {
                "used": 0,
                "end_date": "2025-02-28T00:00:00.000Z",
                "start_date": "2024-03-01T00:00:00.000Z"
              },
              {
                "used": 0,
                "end_date": "2024-02-29T00:00:00.000Z",
                "start_date": "2023-03-01T00:00:00.000Z"
              },
              {
                "used": 0,
                "end_date": "2023-02-28T00:00:00.000Z",
                "start_date": "2022-03-01T00:00:00.000Z"
              }
            ],
            "scheduled_until_end_date": 0
          }
        ],
        "is_deel_pto_confirmed": true,
        "additional_details": null
      },
      "desired_end_date": "2025-01-31",
      "eligible_for_rehire": "DONT_KNOW",
      "eligible_for_rehire_reason": "Employee is not eligible for rehire due to performance issues"
    },
    "desired_end_date": "2025-01-31T00:00:00.000Z"
  }
}

Submits PTO details for a resignation request, triggers related notifications, and finalizes the PTO review step. Only callable when the resignation status is AWAITING_PTO.

Token scopes: contracts:write

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.

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

Learn more about authentication

AuthorizationBearer

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

Path parameters

contract_idstringRequired

The unique identifier of the employee contract.

Request

This endpoint expects an object.

dataobjectOptional

Response

PTO review submitted successfully.

dataobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error