---
title: "Retrieves an interview"
method: GET
path: "/interviews/{interviewId}"
tags: ["interviews"]
---

# Retrieves an interview

`GET /interviews/{interviewId}`

Interview details

## Response `200`

Interview

- 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 an interview
- `404` — with codes: * **INTERVIEW_NOT_FOUND** when no interview 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)
