Skip to navigation
EndpointsAts

List available slots for an interview

Beta

Finds the times the interviewers of an interview are all free, based on the interview’s calendar settings, so a time can be proposed to the candidate before booking it. Book a chosen slot with PATCH /rest/ats/applications/{application_id}/application-activities/{application_activity_id}/scheduled-interviews.

Token scopes: ats:read, worker:read

Beta: this version requires the X-Beta: true request header and its contract may change before it is promoted to stable. It is scheduled to become stable on 2027-01-29.

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.deel.training/rest/v2/contracts' \
  -H 'Authorization: Bearer YOUR-TOKEN-HERE'

Learn more about authentication

OR
AuthorizationBearer

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

Path parameters

application_idstringRequiredformat: "uuid"
ID of the application the interview belongs to
application_activity_idstringRequiredformat: "uuid"
ID of the interview scheduling activity of the application

Headers

X-BetaenumRequiredDefaults to true

Opts in to the beta version of this endpoint. Must be true.

Allowed values:

Query parameters

start_timestringRequiredformat: "date-time"
Start of the window to search for available slots
end_timestringRequiredformat: "date-time"

End of the window to search for available slots, at most 31 days after start_time

timezonestringRequired
IANA timezone the slots are computed in

Response

Available interview slots
datalist of objects
Available slots in the window, earliest first
has_moreboolean

Always false: every slot in the window is returned at once.

next_cursorstring or null

Always null: every slot in the window is returned at once.

total_countinteger
Number of available slots in the window.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
500
Internal Server Error