Skip to navigation
EndpointsAts

List interviews across applications

Lists interviews for review, including who interviewed and whether each took place or was cancelled. By default each application contributes only the interviews of the stage it is in now; filter by applications or interview stages to also get interviews from stages it has already passed. Results are limited to interviews the caller may see.

Token scopes: ats:read, worker:read

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/

Query parameters

interviewer_hou_idslist of stringsOptional

Filter interviews by interviewer HRIS organization user IDs (from GET /rest/ats/hiring-members). Also matches interviews created by those users. For non-admins in organizations without roles and permissions, the filter always resolves to the authenticated user, whatever is passed.

job_idslist of stringsOptional
Filter interviews by job IDs.
statuslist of enumsOptional

Filter interviews by status. Unless application_ids, interview_plan_stage_ids or a date range is given, including SCHEDULED leaves out SCHEDULED interviews whose meeting is already over.

candidate_idslist of stringsOptional
Filter interviews by candidate IDs.
application_idslist of stringsOptional

Filter interviews by application IDs. When set, every interview of those applications is returned — past, cancelled and on stages the candidate has already moved past — and results default to latest meeting first.

interview_plan_stage_idslist of stringsOptional

Filter interviews by the interview plan stage the interview belongs to (from GET /rest/ats/jobs interview_plan_stages). When set, every interview on those stages is returned regardless of the candidate’s current stage, and results default to latest meeting first.

date_range_startstringOptionalformat: "date-time"

Lower bound of interview start time (ISO 8601); interviews without a start time match on creation time. Setting a date range also returns past, completed interviews on stages the candidate has moved past.

date_range_endstringOptionalformat: "date-time"

Upper bound of interview start time (ISO 8601); interviews without a start time match on creation time. Setting a date range also returns past, completed interviews on stages the candidate has moved past.

updated_afterstringOptionalformat: "date-time"

Return interviews updated strictly after this ISO 8601 datetime (incremental sync).

sort_orderenumOptional

Order interviews by upcoming-first, newest-first (by creation), oldest-first, or latest-meeting-first (most recent meeting time, for past-interview views).

Allowed values:
cursorstringOptional
Pagination cursor returned by a previous response.
limitintegerOptional1-100
Maximum number of interviews to return per page.

Response

Paginated list of interviews
datalist of objects
Page of interviews.
has_moreboolean
Whether more pages are available beyond the current page.
next_cursorstring or null

Cursor to fetch the next page; null when there are no more pages.

total_countinteger
Total number of interviews matching the filters.

Errors

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