---
title: "List candidate events (DEPRECATED). This API is deprecated."
method: GET
path: "/v0/candidates/{candidate_id}/events"
tags: ["Candidate Events"]
---

# List candidate events (DEPRECATED). This API is deprecated.

`GET /v0/candidates/{candidate_id}/events`

## Request

- Base URL: `https://api.gem.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.gem.com/v0/candidates/{candidate_id}/events`
- Auth: none declared

Returns a list of all events for the given candidate and supports pagination and search
parameters `created_after`, `created_before`.

## Query parameters

- `created_after` integer
- `created_before` integer
- `sort` 'asc' | 'desc'
- `page` integer
- `page_size` integer

## Response `200`

OK

- CandidateEvent[]
  - `id` string, ObjectID
  - `candidate_id` string, ObjectID
  - `timestamp` integer, required
  - `user_id` string, ObjectID, required
  - `on_behalf_of_user_id` string, ObjectID, nullable
  - `project_id` string, ObjectID, required
  - `sequence_id` string, ObjectID, required
  - `type` 'sequences' | 'sequence_replies' | 'manual_touchpoints', required
  - `subtype` 'first_outreach' | 'follow_up' | 'reply', required
  - `contact_medium` 'inmail' | 'phone_call' | 'text_message' | 'email' | 'meeting' | 'li_connect_request', required
  - `reply_status` unknown

## Other responses

- `422`: Unprocessable Content
- `default`: Default error response

---

[API](https://skmtc.dev/gem/apis/gem-crm-api.md) - [All operations](https://skmtc.dev/gem/apis/gem-crm-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gem/apis/gem-crm-api/revisions/50a984e3c2b5?raw)