---
title: "Retrieve webhook subscription"
method: GET
path: "/v1/webhook_subscriptions/{id}"
tags: ["Webhook Subscriptions"]
---

# Retrieve webhook subscription

`GET /v1/webhook_subscriptions/{id}`

## Request

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

Retrieves a webhook subscription by ID.

## Path parameters

- `id` string, uuid, required

## Response `200`

The webhook subscription resource

- WebhookSubscriptionResourceDto
  - `id` string, required: Unique identifier of the webhook subscription.
  - `type` 'webhook_subscription', required: Resource type discriminator.
  - `url` string, required: The HTTPS URL where webhook events are delivered.
  - `events` string[], required: Event types this subscription receives.
  - `metadata` object, required: Set of up to 50 key-value string pairs you can attach to store structured information, such as correlating this resource with an object in your own system. Keys may be up to 40 characters and values up to 500 characters.
  - `created_at` string, date-time, required: ISO 8601 UTC timestamp when the subscription was created.
  - `updated_at` string, date-time, required: ISO 8601 UTC timestamp when the subscription was last updated.

## 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 `events/items/` response property for the response status `200`
  - added the new `account_holder.closed` enum value to the `events/items/` response property for the response status `200`
- **2026-04-23** `f04b2c330a67`: 3 warning
  - added the new `conversion.completed` enum value to the `events/items/` response property for the response status `200`
  - added the new `conversion.created` enum value to the `events/items/` response property for the response status `200`
  - added the new `conversion.failed` enum value to the `events/items/` response property for the response status `200`
- **2026-04-21** `67983e71dc41`: 1 warning
  - added the new `deposit.received` enum value to the `events/items/` response property for the response status `200`
- **2026-04-15** `d91795c11a31`: 4 warning
  - added the new `return.failed` enum value to the `events/items/` response property for the response status `200`
  - added the new `return.initiated` enum value to the `events/items/` response property for the response status `200`
  - added the new `return.paid` enum value to the `events/items/` response property for the response status `200`
  - added the new `return.returned` enum value to the `events/items/` response property for the response status `200`

[Operation history](https://skmtc.dev/augustus/apis/ivy-api/changes/v1/webhook_subscriptions/: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)