Business API

Appearance

Get a webhook event​

GET
/v1/webhooks/{id}/events/{eventId}

Requires WEBHOOKS_READ, granted by WEBHOOKS_WRITE (bundles)

Returns one event sent to a webhook: the exact JSON body that was delivered, as a string, and every attempt to deliver it, oldest first. Keys restricted to sub-accounts can't use this endpoint.

Parameters​

Path Parameters

id*

Webhook ID: the identifier returned when the webhook was created.

Type
string
Required
Example"0b8f5d2e-7a41-4c3b-9e6d-2f1a8c7b5e90"
Format
"uuid"
eventId*

Event ID: the eventId of a delivery attempt, or the Valr-Webhook-Event-Id header of a delivery.

Type
string
Required
Example"6c2e9b41-3d7f-4a8e-b5c1-9f0a2d4e6b8c"
Format
"uuid"

Responses​

OK

application/json
JSON
{
"eventId": "6c2e9b41-3d7f-4a8e-b5c1-9f0a2d4e6b8c",
"eventType": "FIAT_DEPOSIT_CREDITED",
"payload": "{"id":"6c2e9b41-3d7f-4a8e-b5c1-9f0a2d4e6b8c","type":"FIAT_DEPOSIT_CREDITED","createdAt":1792743330123,"apiVersion":"2026-09-16","subAccount":null,"data":{"depositId":"3f1c2a9e-8b4d-4c1e-9f2a-6d7e8b9c0a1b","amount":"1500","currencySymbol":"ZAR","reference":"VLR4F7K2Q9","effectiveDate":1792713600000,"creditedAt":1792743330000}}",
"attempts": [
{
"eventId": "6c2e9b41-3d7f-4a8e-b5c1-9f0a2d4e6b8c",
"eventType": "FIAT_DEPOSIT_CREDITED",
"attemptNumber": 1,
"errorCategory": "TIMEOUT",
"errorMessage": "Your endpoint did not respond within the delivery timeout.",
"nextRetryAt": "2026-10-23T08:16:03.512874Z",
"createdAt": "2026-10-23T08:15:33.512874Z"
},
{
"eventId": "6c2e9b41-3d7f-4a8e-b5c1-9f0a2d4e6b8c",
"eventType": "FIAT_DEPOSIT_CREDITED",
"attemptNumber": 2,
"responseStatus": 200,
"terminalState": "SUCCESS",
"createdAt": "2026-10-23T08:16:04.108392Z"
}
]
}

Samples​

Errors

HTTPErrorWhen
400-11INVALID_REQUESTThe webhook ID or event ID isn't a valid UUID.
404-18121WEBHOOK_SUBSCRIPTION_NOT_FOUNDNo webhook with this ID exists for your business.
404-18123WEBHOOK_EVENT_NOT_FOUNDThis webhook hasn't sent an event with this ID.

Plus the errors common to all signed endpoints.