Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.offthehook.dev/llms.txt

Use this file to discover all available pages before exploring further.

Use this endpoint to inspect any single event in a subscription’s delivery history. The response includes the current status, attempt and delivery counts, the last HTTP response from your endpoint, and the complete Standard Webhooks payload. This is the most direct way to investigate a specific delivery failure.

​
Request

GET /v1/subscriptions/:id/events/:eventId

​
Path parameters

​
id
string
required
The subscription ID (e.g. sub_2QkP9aB7xN...).
​
eventId
string
required
The event ID (e.g. evt_8xN9kP2QbA...).
curl https://api.offthehook.dev/v1/subscriptions/sub_2QkP9aB7xN.../events/evt_8xN9kP2QbA... \
  -H "Authorization: Bearer oth_YOUR_API_KEY"

​
Response

200 OK — a single EventView object with the same shape as items in the list events response. 
{
  "id": "evt_8xN9kP2QbA...",
  "subscriptionId": "sub_2QkP9aB7xN...",
  "kind": "wallet.transfer.broadcasted",
  "chainId": "tron:mainnet",
  "status": "delivered",
  "attempts": 1,
  "deliveryCount": 1,
  "responseStatus": 200,
  "responseBody": "OK",
  "payload": {
    "id": "evt_8xN9kP2QbA...",
    "kind": "wallet.transfer.broadcasted",
    "date": "2026-05-08T12:34:56Z",
    "data": {}
  },
  "dateCreated": "2026-05-08T12:34:56Z"
}
​
id
string
Unique event ID. This value is sent in the webhook-id delivery header and is your idempotency key for deduplication.
​
subscriptionId
string
The subscription this event belongs to.
​
kind
string
The event type, e.g. wallet.transfer.broadcasted or service.ping.
​
chainId
string | null
CAIP-2 identifier for the chain this event originated on. null for service events like service.ping.
​
status
string
Current delivery status: pending, delivered, or failed.
​
attempts
integer
Number of delivery attempts in the current dispatch cycle. Resets to 0 on retry.
​
deliveryCount
integer
Monotonic count of successful deliveries across all dispatch cycles.
​
responseStatus
integer | null
The HTTP status code from your endpoint on the last attempt. null if no HTTP response was received.
​
responseBody
string | null
Truncated response body from the last attempt. null if no body was received.
​
payload
object
The exact Standard Webhooks envelope sent to your endpoint.
​
dateCreated
string
ISO 8601 timestamp of when this event was created.

​
Errors

CodeHTTPDescription
not_found404The event ID does not exist, does not belong to the given subscription, or the subscription belongs to a different API key.
unauthorized401The Authorization header is missing or the key is invalid.