List interviews | Deel | Documentation

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

{
  "data": [
    {
      "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "created_at": "2026-01-15T08:00:00Z",
      "updated_at": "2026-01-20T14:30:00Z",
      "application": {
        "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "job": {
          "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
          "title": "Frontend Engineer"
        },
        "candidate": {
          "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
          "email": "jane.smith@example.com",
          "last_name": "Smith",
          "first_name": "Jane",
          "pic_url": "https://avatars.githubusercontent.com/u/12345678"
        }
      },
      "status_enum": "SCHEDULED",
      "application_activity": {
        "interview_title": "Technical Round",
        "length_in_minutes": 60,
        "application_activity_participations": [
          {
            "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
            "participant_hris_organization_user_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
            "application_activity_feedbacks": [
              {
                "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
              }
            ],
            "participant_hris_organization_user_profile": {
              "type": "CLIENT",
              "country": "US",
              "pic_url": "https://avatars.githubusercontent.com/u/12345678",
              "full_name": "Jane Smith",
              "job_title": "Engineering Manager",
              "last_name": "Smith",
              "first_name": "Jane",
              "work_email": "jane.smith@example.com",
              "hris_organization_user_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
            }
          }
        ]
      },
      "application_activity_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "ends_at": "2026-06-01T11:00:00Z",
      "timezone": "America/New_York",
      "starts_at": "2026-06-01T10:00:00Z",
      "meeting_url": "https://meet.example.com/abc-123"
    }
  ],
  "has_more": false,
  "next_cursor": "eyJpZCI6IjEyMzQifQ==",
  "total_count": 42
}

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. ```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

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'

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