/api/public/v1/time-off-requestsRequest time off
Files a request for the employee the token acts as — never for somebody else, which is why there is no `employeeId` here. The request goes to that employee’s assigned manager and to nobody else — the managers above that one can see it and may decide it, but only the direct manager is notified about it. Someone with no manager has nobody to wait on, so their request is approved on the spot rather than sitting PENDING forever; the response says which happened via `autoApproved`. Either way, whoever needs to know is notified in-app and by SMS.
Required scope
The access token must carry this scope. A token missing it gets 403 Forbidden. Grant them to an API client under Settings → Company → API, and to a teammate under Employee → Permissions.
Request Body
| Property | Type | Description |
|---|---|---|
type | string | Kind of leave. |
startDate | string | `YYYY-MM-DD`. |
endDate | string | `YYYY-MM-DD`, on or after `startDate`. |
startTime | string | `HH:mm` (24-hour), for time off that covers part of a day. Send it with `endTime` or not at all — leave both out for whole days. Read in the employee’s own timezone; the response carries the resulting `startsAt`, `endsAt` and `timezone`. |
endTime | string | `HH:mm` (24-hour), on `endDate`. Must fall after `startDate` at `startTime`. Required whenever `startTime` is sent. |
note | string | Context for whoever reviews it. |
curl -X POST "https://www.pxb.app/api/public/v1/time-off-requests" \
-H "Authorization: Bearer your_access_token" \
-H "Content-Type: application/json" \
-d '{
"type": "VACATION",
"startDate": "2026-09-14",
"endDate": "2026-09-18",
"note": "Family trip."
}'{
"message": "Time-off request submitted.",
"content": {
"request": {
"id": "tor_31aa",
"employeeId": "emp_44f1",
"type": "VACATION",
"status": "PENDING",
"startDate": "2026-09-14",
"endDate": "2026-09-18",
"startsAt": null,
"endsAt": null,
"timezone": null,
"note": "Family trip.",
"reviewedById": null,
"reviewedAt": null,
"reviewNote": null,
"createdAt": "2026-08-20T09:00:00.000Z",
"updatedAt": "2026-08-20T09:00:00.000Z"
},
"autoApproved": false
}
}In the console
The same thing done by hand, for anyone comparing the API against the screen they already use.