List available timeslots

GET

/timeslots

Timeslots

Last modified:2026-06-17 18:03:20

Maintainer:Not configured

Returns available interview timeslots for a given interview type based on interviewer availability. Slots are generated based on interviewer calendars, filtered to 5+ days ahead.

Use these results to pick a date and time to pass to POST /timeslots/hold.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Responses

🟢200

application/json

Available timeslots.

Bodyapplication/json

🟠401Unauthorized

🟠422ValidationError

Request Example

Shell

JavaScript

Java

Swift

curl --location '/timeslots?interview_type_id=undefined&months_ahead=undefined&date=undefined' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Success

{
    "data": [
        {
            "date": "2026-06-10",
            "time": "09:00",
            "interview_type": {
                "id": 4,
                "name": "Clinical Interview"
            }
        },
        {
            "date": "2026-06-10",
            "time": "10:00",
            "interview_type": {
                "id": 4,
                "name": "Clinical Interview"
            }
        }
    ],
    "meta": {
        "interview_type_id": 4,
        "months_ahead": 2,
        "total": 2
    }
}

Modified at 2026-06-17 18:03:20

List active interview types

Hold a timeslot