Create leave request

Develop Env

https://dev.your-api-server.com

POST

/leaves

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Body Params application/jsonRequired

Example

{
    "leave_type": "annual",
    "start_date": "2025-12-01",
    "end_date": "2025-12-05",
    "days": 5,
    "reason": "Family vacation"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://dev.your-api-server.com/leaves' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "leave_type": "annual",
    "start_date": "2025-12-01",
    "end_date": "2025-12-05",
    "days": 5,
    "reason": "Family vacation"
}'

Responses

🟢201Created

application/json

Leave request created successfully

Body

Example

{
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "employee_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "leave_type": "annual",
    "start_date": "2025-12-01",
    "end_date": "2025-12-05",
    "days": 5,
    "status": "pending",
    "approved_by": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "reason": "Family vacation",
    "created_at": "2025-11-15T10:30:00Z",
    "updated_at": "2025-11-15T10:30:00Z"
}

🟠400Bad Request

🟠401Unauthorized

Modified at 2025-11-17 05:13:15

List leaves

Approve/reject leave