---
title: "Retrieve an Event"
method: GET
path: "/events/{event-id}"
tags: ["events"]
---

# Retrieve an Event

`GET /events/{event-id}`

## Request

- Base URL: `https://api.withpersona.com/api/v1`
- URL: `https://api.withpersona.com/api/v1/events/{event-id}`
- Auth: HTTP bearer

Retrieves the details of an existing event.

## Path parameters

- `event-id` string, required

## Query parameters

- `include` string
- `fields` object

## Headers

- `Key-Inflection` 'camel' | 'kebab' | 'snake'
- `Idempotency-Key` string
- `Persona-Version` '2026-09-29' | '2025-12-08' | '2025-10-27' | '2023-01-05' | '2022-09-01' | '2021-08-18' | '2021-07-05' | '2021-02-21' | '2020-05-18': Server API version. More info on versioning can be found [here](https://docs.withpersona.com/versioning).

## Response `200`

This endpoint returns an Event object.

- EventsRetrieveAnEventResponse200
  - `data` Event, required: An Event object
    - `id` string
    - `attributes` WorkflowRunIncludedObjectsItemsDiscriminatorMappingEventAttributes
      - `name` string
      - `payload` WorkflowRunIncludedObjectsItemsDiscriminatorMappingEventAttributesPayload: For a Persona-defined event, the entire serialized entity that triggered it. For a custom event, the arbitrary body you supplied when creating it, returned exactly as sent -- its keys are never re-cased.
        - `data` WorkflowRunIncludedObjectsItemsDiscriminatorMappingEventAttributesPayloadData
          - `type` string
          - `id` string
          - `attributes` object
          - `relationships` object
      - `created-at` string, date-time
      - `context` object: Additional context populated for some event types. For a custom event, the context you supplied when creating it, or empty if you supplied none.
  - `included` unknown[]: Excluded from the response by default. Will be an empty array when the `include` query parameter in the request was explicitly set to empty.
    - unknown

## Other responses

- `400`: The request was unacceptable, often due to invalid parameters.
- `401`: An invalid API key was provided.
- `403`: The given API key doesn’t have permissions to perform the request or a quota has been exceeded.
- `404`: The requested resource doesn’t exist.
- `429`: Your organization’s rate limit has been exceeded. We recommend an exponential backoff on requests.

---

[API](https://skmtc.dev/withpersona/apis/withpersona-8.md) - [All operations](https://skmtc.dev/withpersona/apis/withpersona-8/llms.txt) - [OpenAPI document](https://skmtc.dev/withpersona/apis/withpersona-8/revisions/3683a7f9e1fe?raw)