List webhook deliveries
Lists webhook deliveries to your subscriptions, newest first, optionally for one subscription_id. One row per delivery, updated in place across retries, so id is the X-Event-ID your endpoint saw and attempt_count is how many tries it took. Confirmation pings are not logged here.
Authorization
apiKey Authorization<token>
API key as Bearer token: Authorization: Bearer
In: header
Query Parameters
limit?integer
Most items to return in one page, from 1 to 100. Defaults to 25.
Default
25Range
1 <= value <= 100cursor?string
pagination.next_cursor from the previous page, to fetch the page after it. Omit it for the first page.
subscription_id?string
Return only deliveries to this subscription ID.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://terac.com/api/external/v2/hooks/events"{
"data": [
{
"id": "string",
"subscription_id": "string",
"event_type": "string",
"resource_id": "string",
"status": "pending",
"attempt_count": 0,
"response_status": 0,
"error_message": "string",
"created_at": "string",
"last_attempt_at": "string",
"delivered_at": "string"
}
],
"pagination": {
"next_cursor": "string",
"has_more": true
}
}{
"code": "BAD_REQUEST",
"message": "Invalid input data",
"issues": []
}{
"error": {
"code": "UNAUTHORIZED",
"message": "API key required. Include Authorization: Bearer <key> header."
}
}{
"error": {
"code": "FORBIDDEN",
"message": "This account is not permitted to use the API."
}
}{
"code": "NOT_FOUND",
"message": "Not found",
"issues": []
}{
"error": {
"code": "RATE_LIMITED",
"message": "Rate limit exceeded. Retry after 61 seconds."
}
}{
"code": "INTERNAL_SERVER_ERROR",
"message": "Internal server error",
"issues": []
}