---
title: "Get an event by token"
method: GET
path: "/events/{event_request_token}"
tags: ["Events"]
---

# Get an event by token

`GET /events/{event_request_token}`

Retrieves a previously submitted event by its event request token, including the original request body.

## Path parameters

- `event_request_token` string, required

## Response `200`

Event found

- object
  - `event_request_token` string
  - `event_type` string — The type of event that was submitted.
  - `events_api_type_id` integer — Internal numeric identifier for the event type.
  - `event_status_id` integer, nullable — Internal identifier for the event status, if one was assigned.
  - `event_lifecycle_id` string, nullable — Lifecycle identifier for grouping related events.
  - `external_event_id` string, nullable — External event identifier provided in the original request.
  - `event_request_status_type_id` integer, nullable — Status type of the event request (e.g. processed, error).
  - `event_request_source` string, nullable — Source of the event request (e.g. API, batch ingestion).
  - `ingestion_batch_token` string, nullable — Token of the ingestion batch, if the event was submitted via batch.
  - `upserted_events_type_id` integer, nullable — For upserted events, indicates whether the upsert resolved to a create or update.
  - `timestamp` string, date-time — Timestamp of when the event request was recorded.
  - `body` object — The original request body that was submitted with the event.

## Other responses

- `404` — Event not found

---

[API](https://skmtc.net/alloy/apis/alloy-api.md) · [All operations](https://skmtc.net/alloy/apis/alloy-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alloy/alloy-api/versions/405799de4d2a/schema)