List interviews

GET

/ats/interviews

GET

/rest/ats/interviews

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

{
  "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"
        },
        "current_application_interview_plan_stage": {
          "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
          "interview_plan_stage": {
            "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
            "name": "Offer"
          }
        }
      },
      "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",
                "submitted_at": "2026-06-01T12:00:00Z",
                "overall_recommendation": {
                  "scale_item_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
                  "scale_item_label": "Strong Yes"
                }
              }
            ],
            "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",
      "cancelled_at": "2026-06-03T15:30:00Z",
      "has_happened": true,
      "cancellation_reason": "Candidate withdrew from the process",
      "interview_plan_stage": {
        "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "name": "Technical Interview",
        "position_number": 2500,
        "default_type_slug": "offer",
        "category_type_slug": "active"
      },
      "cancellation_reason_id": "5d4c3b2a-1f0e-4d9c-8b7a-6f5e4d3c2b1a",
      "application_interview_plan_stage_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "created_by_hris_organization_user_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479"
    }
  ],
  "has_more": false,
  "next_cursor": "eyJpZCI6IjEyMzQifQ==",
  "total_count": 42
}

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

Learn more about 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.

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

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 (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