get
https://api.lirium-sandbox.com/v1/webhooks/events
Search and list webhook event history
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Search through the history of webhook events that have been sent to your subscriptions. Events are returned newest first.
Request
GET /webhooks/events
Query Parameters
This endpoint uses cursor-based pagination. See Pagination for the general behaviour.
| Parameter | Type | Required | Description |
|---|---|---|---|
starting_after | string | No | Cursor. Return events listed after this value. |
ending_before | string | No | Cursor. Return events listed before this value. |
limit | integer | No | Maximum number of events to return. Defaults to 10, must be greater than 0 and less than or equal to 100. |
Cursor values are the 20-character strings returned in the pagination object of a previous response.
Mutually exclusive cursors
starting_afterandending_beforecannot be sent in the same request. Doing so returns a400with error codeinvalid_parameters.
Example Request
GET /webhooks/events?limit=20Example Response
{
"events": [
{
"id": "2",
"created_at": "2025-01-05T12:00:30.000000+00:00",
"delivery_url": "https://partner.example.com/webhooks",
"delivery_tries": 0,
"state": "pending"
},
{
"id": "1",
"created_at": "2025-01-05T12:00:00.000000+00:00",
"delivery_url": "https://partner.example.com/webhooks",
"delivery_tries": 3,
"state": "error"
}
],
"pagination": {
"starting_after": "20250105120000000000",
"ending_before": "20250105120030000000",
"limit": 20
}
}Response Fields
| Field | Type | Required | Description |
|---|---|---|---|
id | string | Yes | Unique event identifier. Use it with Resend Event. |
created_at | timestamp | Yes | When the event was created. |
delivery_url | string | Yes | The subscription URL the event is delivered to. |
delivery_tries | integer | Yes | Number of delivery attempts made so far. |
state | string | No | Delivery state: pending, completed or error. Omitted while the event is queued and has not been picked up for delivery yet. |
Event States
| State | Description |
|---|---|
pending | The event has not been delivered yet, or is waiting for a retry. |
completed | The event was delivered successfully. |
error | Delivery failed and no further automatic retries will be made. |
An event that is queued for delivery — either because it was just created, or because you resent it with Resend Event — has no state yet, and the field is omitted from the response. It appears once delivery is attempted.
Errors
| Status | Error code | Description |
|---|---|---|
| 400 | invalid_parameters | starting_after and ending_before were both sent, limit is outside 1–100, or a cursor value is malformed. |