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

# Retrieve event

`GET /v1/events/{id}`

## Request

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

Retrieves a webhook event by ID.

## Path parameters

- `id` string, uuid, required

## Response `200`

The event resource

- EventResourceDto
  - `id` string, uuid, required: Unique identifier of the event. Matches the envelope `id` delivered in the webhook payload and is stable across subscription fan-out and retries.
  - `type` 'event', required: Resource type discriminator.
  - `event_type` 'payout.initiated' | 'payout.submitted' | 'payout.sent' | 'payout.failed' | 'payout.returned' | 'return.initiated' | 'return.submitted' | 'return.sent' | 'return.failed' | 'return.returned' | 'deposit.settled' | 'conversion.created' | 'conversion.completed' | 'conversion.failed' | 'account_holder.active' | 'account_holder.closed' | 'counterparty.pending' | 'counterparty.active' | 'counterparty.rejected' | 'counterparty.blocked' | 'counterparty.unblocked' | 'counterparty.updated' | 'payout_tracking_event.created' | 'ping.test', required: Event type.
  - `api_version` string, required: API version the event payload was rendered at. Stable across retries and redeliveries, and mirrored in the webhook envelope `api_version` field.
  - `created_at` string, date-time, required: ISO 8601 UTC timestamp when the event was created.
  - `data` object, required: Event payload. Shape matches the resource schema for `event_type`.

## Changes

- **2026-10-16** `f7ded6c181ab`: 1 info
  - endpoint added
- **2026-07-29** `e5198bf3cf7e`: 2 warning
  - added the new `account_holder.active` enum value to the `event_type` response property for the response status `200`
  - added the new `account_holder.closed` enum value to the `event_type` response property for the response status `200`
- **2026-04-24** `75f9878ced37`: 1 info
  - added the required property `api_version` to the response with the `200` status
- **2026-04-23** `f04b2c330a67`: 4 warning
  - added the new `conversion.completed` enum value to the `event_type` response property for the response status `200`
  - added the new `conversion.created` enum value to the `event_type` response property for the response status `200`
  - added the new `conversion.failed` enum value to the `event_type` response property for the response status `200`
  - added the new `ping.test` enum value to the `event_type` response property for the response status `200`
- **2026-04-22** `7e26180bf667`: 1 info
  - endpoint added

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

---

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