List webhook subscription events

curl --request GET \
  --url https://api.cdp.coinbase.com/platform/v2/data/webhooks/subscriptions/{subscriptionId}/events \
  --header 'Authorization: Bearer <token>'

{
  "events": [
    {
      "eventId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "eventTypeName": "onchain.activity.detected",
      "status": "succeeded",
      "createdAt": "2025-01-15T10:30:00Z",
      "succeededAt": "2025-01-15T10:30:02Z",
      "retryCount": 0,
      "response": {
        "httpCode": 200,
        "elapsedTimeMs": 142,
        "body": "ok"
      }
    }
  ]
}

Webhooks

List webhook subscription events

Retrieve webhook event delivery attempts for a specific subscription. Returns event deliveries in descending order by creation time (newest first), including delivery status, retry count, and response details.

Use Cases

Debug webhook delivery failures and inspect response codes
Monitor delivery status and retry counts
Audit event delivery history for a subscription
Verify that expected events were sent to webhook URLs

Filtering

Use optional query parameters to narrow results:

eventId — find a specific event by ID
minCreatedAt / maxCreatedAt — filter by time range
eventTypeNames — filter by event type (comma-separated)

Note: Results are limited to the 50 most recent events (newest first). No pagination is supported.

GET

data

webhooks

subscriptions

{subscriptionId}

events

List webhook subscription events

curl --request GET \
  --url https://api.cdp.coinbase.com/platform/v2/data/webhooks/subscriptions/{subscriptionId}/events \
  --header 'Authorization: Bearer <token>'

{
  "events": [
    {
      "eventId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "eventTypeName": "onchain.activity.detected",
      "status": "succeeded",
      "createdAt": "2025-01-15T10:30:00Z",
      "succeededAt": "2025-01-15T10:30:02Z",
      "retryCount": 0,
      "response": {
        "httpCode": 200,
        "elapsedTimeMs": 142,
        "body": "ok"
      }
    }
  ]
}

Authorizations

Authorization

string

header

required

A JWT signed using your CDP API Key Secret, encoded in base64. Refer to the Generate Bearer Token section of our Authentication docs for information on how to generate your Bearer Token.

Path Parameters

subscriptionId

string<uuid>

required

Unique identifier for the webhook subscription.

Pattern: ^[a-f0-9\-]{36}$

Query Parameters

eventId

string<uuid>

Filter by a specific event ID.

minCreatedAt

string<date-time>

Filter events created at or after this timestamp (RFC 3339 format).

maxCreatedAt

string<date-time>

Filter events created at or before this timestamp (RFC 3339 format).

eventTypeNames

string

Filter by event type names (comma-separated).

Response

Webhook events retrieved successfully.

Response containing a list of webhook event delivery attempts.

events

object[]

required

The list of webhook event delivery attempts.

Show child attributes

Get webhook subscription

List webhook subscriptions

⌘I