List interviews

Scheduled interviews with time, interviewers and candidate, for one candidate or a date range.

GET https://cotlet.dev/api/v1/ashby/interviews

read

Returns the interviews already scheduled in Ashby, soonest first. Pass candidate_id to see one candidate, or a date range to see what is booked across the team, for example to check an interviewer for clashes before schedule_interview.

Parameters

Parameters: list_interviews
Name	Type	Description
candidate_id string	string	Only interviews of this candidate.
from string	string	ISO date. Default: today.
to string	string	ISO date. Default: 14 days after from.

Request

   cURL   Python   Node.js   CLI  
 cURL curl https://cotlet.dev/api/v1/ashby/interviews \
  -H "Authorization: Bearer $COTLET_API_KEY"  Python result = client.call("ashby", "list_interviews")  Node.js const result = await cotlet.call('ashby', 'list_interviews');  CLI cotlet call ashby list_interviews 

Example response

JSON

{
  "interviews": [
    {
      "interview": "Technical screen",
      "candidate": "Lena Fischer",
      "start": "2026-10-23T11:00:00+02:00",
      "duration_minutes": 45,
      "interviewers": [
        "priya.nair@example.com"
      ],
      "location": "Google Meet"
    }
  ]
}

Parameters

Request

Example response

Sign in once. Your agent does the rest.

Analytics cookies