interviews.list

List interviews

Request: GET/api/v1/interviews
Scope required: interviews:read
Effect: Reads only. Safe to retry and safe for an agent to call unprompted.
Acts on: Serves an account’s own data and, where shared, an organization’s.
MCP tool: interviews_list
Environment: Live and sandbox alike.
Request body: JSON.

What it does

Returns interviews soonest first. With no `applicationId` it lists every interview the account has, which is how an agent answers "what is coming up this week" — narrow it with `from` and `to`. With an `applicationId` it lists that card's interviews instead, and organization staff reading a shared board may call it that way for the cards that board holds. `from` and `to` are ignored when an `applicationId` is given, because a single card has few enough interviews to read whole. A credential restricted to one organization must name an `applicationId`: the whole account's diary is not that organization's to read. Read a single interview whole with `interviews.get`.

Parameters

Parameters this endpoint accepts, where each one goes, and whether it is required
Name	Sent in	Requirement	Accepts
applicationId	query	Optional	string
from	query	Optional	string
to	query	Optional	string
limit	query	Optional	integer
cursor	query	Optional	string

Response

data

array of object, required

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

hasMore

boolean, required

nextCursor

string or null, required

Examples

Everything scheduled

Everything scheduled — request

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

Everything scheduled — response

{
  "data": [
    {
      "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"
    }
  ],
  "hasMore": false,
  "nextCursor": null
}