---
title: "Get an event"
method: GET
path: "/v1/events/{event_id}"
tags: ["Events"]
---

# Get an event

`GET /v1/events/{event_id}`

## Request

- Base URL: `https://api.recruitmcp.com`
- URL: `https://api.recruitmcp.com/v1/events/{event_id}`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://recruitmcp.com/oauth/authorize`, token URL `https://recruitmcp.com/oauth/token`, scopes: `account:read`)

Scope: `account:read`.

## Path parameters

- `event_id` string, required

## Headers

- `RecruitMCP-Version` '2026-10-13'
- `RecruitMCP-Customer` string

## Response `200`

The event.

- Event
  - `id` string, required
  - `object` 'event', required
  - `type` 'job.completed' | 'job.failed' | 'contacts.completed' | 'enrollment.created' | 'enrollment.completed' | 'enrollment.failed' | 'action.sent' | 'action.failed' | 'action.awaiting_approval' | 'reply.received' | 'invite.accepted' | 'account.connected' | 'account.paused' | 'account.disconnected' | 'outreach.cap_reached' | 'credits.low' | 'credits.expiring' | 'credits.purchased' | 'credits.granted' | 'credits.used' | 'credits.payg_alert', required
  - `created_at` string, date-time, required
  - `customer_id` string, nullable
  - `data` object, required: The object the event is about. Fields depend on type.

## Other responses

- `400`: `invalid_request` (do not retry): A field is missing or has a value this endpoint does not accept. `unsupported_version` (do not retry): RecruitMCP-Version is not a supported version.
- `401`: `unauthorized` (do not retry): Missing bearer API key.
- `403`: `forbidden` (do not retry): This customer is disabled. `insufficient_scope` (do not retry): This key does not include the scope this endpoint requires.
- `404`: `not_found` (do not retry): No record with this id exists in the workspace.
- `429`: `rate_limited` (retry): Per-key rate limit exceeded.

## Changes

- **2026-10-20** `ad27b35513a6`: 5 warning
  - added the new `approval_forced` enum value to the `error/code` response property for the response status `400`
  - added the new `approval_forced` enum value to the `error/code` response property for the response status `401`
  - added the new `approval_forced` enum value to the `error/code` response property for the response status `403`
  - added the new `approval_forced` enum value to the `error/code` response property for the response status `404`
  - …1 more

[Operation history](https://skmtc.dev/recruitmcp/apis/recruitmcp-api/changes/v1/events/:event_id/get.md)

---

[API](https://skmtc.dev/recruitmcp/apis/recruitmcp-api.md) · [All operations](https://skmtc.dev/recruitmcp/apis/recruitmcp-api/llms.txt) · [OpenAPI document](https://skmtc.dev/recruitmcp/apis/recruitmcp-api/revisions/ad27b35513a6?raw)