---
title: "GET /candidates/{candidate_id}/meetings/"
method: GET
path: "/candidates/{candidate_id}/meetings/"
tags: ["candidates"]
---

# GET /candidates/{candidate_id}/meetings/

`GET /candidates/{candidate_id}/meetings/`

## Request

- Base URL: `https://api.manatal.com/open/v3`
- URL: `https://api.manatal.com/open/v3/candidates/{candidate_id}/meetings/`
- Auth: API key in header `Authorization`

Returns the AI Interviewer and AI Notetaker meetings of a candidate, with links to each meeting's recording, transcription and AI assessment. Requires the `candidate_api_scope` token scope.

## Query parameters

- `meeting_source` 'ai_interviewer' | 'ai_notetaker'
- `meeting_time__gte` string, date-time
- `meeting_time__lte` string, date-time
- `page` integer
- `page_size` integer

## Response `200`

- object
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` object[], required
    - `id` integer, required
    - `client_id` integer, required
    - `activity_id` integer, nullable: ID of the linked activity.
    - `title` string, nullable
    - `meeting_time` string, date-time, nullable: Scheduled start time of the meeting.
    - `content_type` string, nullable: Parent object type, such as candidate or contact.
    - `object_id` integer, nullable: ID of the parent object named by content_type.
    - `hosted_by` integer, nullable: ID of the user who hosted the meeting.
    - `recording_url` string, uri, nullable: Presigned URL of the meeting recording.
    - `transcription_url` string, uri, nullable: Presigned URL of the meeting transcription.
    - `assessment_url` string, uri, nullable: Presigned URL of the meeting AI assessment.
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `job_id` integer, nullable
    - `candidate_id` integer, nullable
    - `status` string, nullable: Meeting status code.
    - `source_type` string, nullable: Meeting source code.
    - `duration` integer, nullable: Meeting duration.

---

[API](https://skmtc.dev/manatal/apis/manatal-open-api.md) - [All operations](https://skmtc.dev/manatal/apis/manatal-open-api/llms.txt) - [OpenAPI document](https://skmtc.dev/manatal/apis/manatal-open-api/revisions/564633b3d03b?raw)