---
title: "Retrieves a list of interviews"
method: GET
path: "/interviews"
tags: ["interviews"]
---

# Retrieves a list of interviews

`GET /interviews`

List of interviews

## Query parameters

- `applicationId` string, uuid, required

## Response `200`

List of interviews

- InterviewsList
  - `content` Interview[]
    - `id` string, guid
    - `candidate` Candidate
      - `id` string, uuid, required
      - `status` 'accepted' | 'declined' | 'pending' | 'tentative' | 'null', nullable — This property is deprecated. Use 'timeslot.candidateStatus' instead.
    - `jobId` string, uuid
    - `location` string — Address, video link, phone number, etc. vary based on the locationType
    - `locationType` 'ONSITE_JOB' | 'ONSITE' | 'PHONE' | 'VIDEO' | 'VIDEO_CALENDAR' | 'VIDEO_MEETING_ZOOM' | 'OTHER' — Type of the location field: * **ONSITE_JOB**: Interview at the job's physical location * **ONSITE**: Interview at any physical location (not necessarily the job site) * **PHONE**: Phone number * **VIDEO**: Generic video meeting link * **VIDEO_CALENDAR**: Video meeting link scheduled through calendar integration * **VIDEO_MEETING_ZOOM**: Zoom video meeting link * **OTHER**: Any other location information
    - `organizerId` string
    - `timezone` string — Name of the timezone as described in TZ database
    - `timeslots` Timeslot[]
      - `id` string, guid
      - `interviewType` string
      - `title` string
      - `place` string
      - `startsOn` string, date-time, required
      - `endsOn` string, date-time, required
      - `interviewers` Interviewer[], required
        - `id` string, required
        - `status` 'accepted' | 'declined' | 'pending' | 'tentative', required
      - `candidateStatus` 'accepted' | 'declined' | 'pending' | 'tentative'
      - `noShow` boolean
    - `createdOn` string, date-time — If not set it defaults to current time
    - `refUrl` string, url
    - `refId` string, refId
    - `source` string

## Other responses

- `403` — Forbidden to access interviews list
- `404` — with codes: * **APPLICATION_NOT_FOUND** when no application found with given id
- `500` — Unexpected error

---

[API](https://skmtc.net/smartrecruiters/apis/apply-api.md) · [All operations](https://skmtc.net/smartrecruiters/apis/apply-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smartrecruiters/apply-api/revisions/449bdc2516c9/schema)