List interviews

GET

/ats/interviews

GET

/rest/v2/ats/interviews

$ curl -G https://api.letsdeel.com/rest/v2/ats/interviews \
>      -H "Authorization: Bearer <token>" \
>      -d interviewer_hou_ids=f47ac10b-58cc-4372-a567-0e02b2c3d479 \
>      -d job_ids=f47ac10b-58cc-4372-a567-0e02b2c3d479 \
>      -d status=SCHEDULED \
>      -d candidate_ids=f47ac10b-58cc-4372-a567-0e02b2c3d479 \
>      --data-urlencode date_range_start=2026-01-01T00:00:00Z \
>      --data-urlencode date_range_end=2026-12-31T23:59:59Z \
>      --data-urlencode updated_after=2026-01-01T00:00:00Z \
>      -d sort_order=SCHEDULED_FIRST \
>      -d cursor=eyJpZCI6IjEyMzQifQ \
>      -d limit=30

1 {
2   "data": [
3     {
4       "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
5       "created_at": "2026-01-15T08:00:00Z",
6       "updated_at": "2026-01-20T14:30:00Z",
7       "application": {
8         "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
9         "job": {
10           "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
11           "title": "Frontend Engineer"
12         },
13         "candidate": {
14           "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
15           "email": "jane.smith@example.com",
16           "last_name": "Smith",
17           "first_name": "Jane",
18           "pic_url": "https://avatars.githubusercontent.com/u/12345678"
19         }
20       },
21       "status_enum": "SCHEDULED",
22       "application_activity": {
23         "interview_title": "Technical Round",
24         "length_in_minutes": 60,
25         "application_activity_participations": [
26           {
27             "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
28             "participant_hris_organization_user_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
29             "application_activity_feedbacks": [
30               {
31                 "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
32               }
33             ],
34             "participant_hris_organization_user_profile": {
35               "type": "CLIENT",
36               "country": "US",
37               "pic_url": "https://avatars.githubusercontent.com/u/12345678",
38               "full_name": "Jane Smith",
39               "job_title": "Engineering Manager",
40               "last_name": "Smith",
41               "first_name": "Jane",
42               "work_email": "jane.smith@example.com",
43               "hris_organization_user_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
44             }
45           }
46         ]
47       },
48       "application_activity_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
49       "ends_at": "2026-06-01T11:00:00Z",
50       "timezone": "America/New_York",
51       "starts_at": "2026-06-01T10:00:00Z",
52       "meeting_url": "https://meet.example.com/abc-123"
53     }
54   ],
55   "has_more": false,
56   "next_cursor": "eyJpZCI6IjEyMzQifQ==",
57   "total_count": 42
58 }

Returns a paginated list of interviews for the organization. Token scopes: ats: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.

1 curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \
2   -H 'Authorization: Bearer YOUR-TOKEN-HERE'

Learn more about authentication

## 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 curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \ -H 'Authorization: Bearer YOUR-TOKEN-HERE' ``` [Learn more about authentication](/api/authentication)

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.

job_idslist of stringsOptional

Filter interviews by job IDs.

statuslist of enumsOptional

Filter interviews by status.

Allowed values:

candidate_idslist of stringsOptional

Filter interviews by candidate IDs.

date_range_startstringOptionalformat: "date-time"

Lower bound of interview start time (ISO 8601).

date_range_endstringOptionalformat: "date-time"

Upper bound of interview start time (ISO 8601).

updated_afterstringOptionalformat: "date-time"

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

sort_orderenumOptional

Order interviews by upcoming-first, newest-first, or oldest-first.

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

1	curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \
2	-H 'Authorization: Bearer YOUR-TOKEN-HERE'