interviews.get

Read one interview

Request: GET/api/v1/interviews/{interviewId}
Scope required: interviews:read
Effect: Reads only. Safe to retry and safe for an agent to call unprompted.
Acts on: Acts on the account’s own job search.
MCP tool: interviews_get
Environment: Live and sandbox alike.
Request body: JSON.

What it does

Returns a single interview with its time, type, location, notes and the feedback recorded afterwards. An interview belonging to another account answers 404, never 403. The response carries a weak `ETag` for use as `If-Match` on `interviews.update`.

Parameters

Parameters this endpoint accepts, where each one goes, and whether it is required
Name	Sent in	Requirement	Accepts
interviewId	path	Required	string
If-Match	header	Optional	string — The ETag of the version you read. The write is refused with 412 if the resource has changed since.

Response

applicationId: string, required
createdAt: string, required
feedback: string or null, required
id: string, required
location: string or null, required
notes: string or null, required
time: string or null, required
type: one of: phone_screen, technical, behavioral, panel, take_home, video_call, in_person, other or null, required
updatedAt: string, required

Examples

One scheduled interview

One scheduled interview — request

curl -s https://www.jobapplicationtracking.com/api/v1/interviews/iv_42 \
  -H "Authorization: Bearer $JAT_KEY"

One scheduled interview — response

{
  "id": "iv_42",
  "applicationId": "app_123",
  "time": "2026-02-20T15:00:00.000Z",
  "type": "technical",
  "location": "Zoom",
  "notes": "Two hours, systems design.",
  "feedback": null,
  "createdAt": "2026-02-11T17:05:00.000Z",
  "updatedAt": "2026-02-11T17:05:00.000Z"
}