The Webhook History Object

A webhook history entry records one delivery attempt of one event to one of your webhooks. Use it to see what was sent, how your endpoint answered, and whether a retry is still pending.

Required scope (OAuth only): view-webhook-history-events

Attributes

Parameter	Type	Description
object	string	Always v2.webhook_history.
id	string	The unique identifier for the history entry.
webhook_id	string	The identifier of the webhook the event was delivered to.
event_name	string	The event that was delivered, for example transaction.paid.
status	string	success when the last response was a 2xx, otherwise failed.
url	string	The URL the event was delivered to, as it was at the time of delivery.
entity_id	string	The identifier of the resource the event is about, for example the transaction id.
data	object	The payload that was sent to your endpoint.
attempts	integer	How many delivery attempts have been made.
max_attempts	integer	The maximum number of attempts before delivery is abandoned.
will_retry	boolean	Whether another attempt is scheduled.
response.status_code	integer|null	HTTP status code returned by your endpoint on the last attempt.
response.body	string|null	Response body returned by your endpoint on the last attempt.
last_attempted_at	string|null	Date and time of the last delivery attempt.
created_at	string|null	Date and time the event was first queued for delivery.

Request

Endpoint: https://youcanpay.com/api/v2/webhook-history/{webhook_history_id}Method: GET

$ curl --location -g --request GET 'https://youcanpay.com/api/v2/webhook-history/6f2e1a0b-7c8d-4e9f-a0b1-c2d3e4f5a6b7' \
  --header 'Accept: application/json' \
  -u 'YOUR_PRIVATE_KEY:'

Response

{
  "object": "v2.webhook_history",
  "id": "6f2e1a0b-7c8d-4e9f-a0b1-c2d3e4f5a6b7",
  "webhook_id": "9b1f2c34-5d6e-4a7b-8c9d-0e1f2a3b4c5d",
  "event_name": "transaction.paid",
  "status": "failed",
  "url": "https://example.com/webhooks/youcan-pay",
  "entity_id": "10e7691c-14a2-4936-833b-ec154c817ce9",
  "data": {
    "id": "f9dc2ad2-a2ac-4608-878c-066f5ceb2ab3",
    "event_name": "transaction.paid",
    "sandbox": false,
    "payload": {}
  },
  "attempts": 2,
  "max_attempts": 3,
  "will_retry": true,
  "response": {
    "status_code": 500,
    "body": "Internal Server Error"
  },
  "last_attempted_at": "2026-09-09 12:10:44",
  "created_at": "2026-09-09 11:58:02"
}