Skip to main content
List Events V2
Use this endpoint to retrieve a paginated list of the events SpherePay has recorded for your application. Every event is queryable whether or not its delivery succeeded, so this is the audit trail behind your webhook traffic. Filter by type (an exact name, a resource wildcard such as transfer.*, or *), by delivery status, by webhookEndpointId, and by the createdStart and createdEnd bounds on creation time. Each item summarizes the event alongside its most recent delivery, including the attempt count and the response your endpoint returned.
Filter by status=failed to find everything that needs attention. A responseCode of null means your endpoint did not respond at all — a timeout or network error rather than an HTTP error.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

object
required

Response

A paginated list of events.

data
object[]
required

Array of event presentations

hasNext
boolean
required

Whether there is a next page

Example:

false

hasPrevious
boolean
required

Whether there is a previous page

Example:

false

limit
number
required

Number of items per page

Required range: 1 < x < 100
Example:

10

page
number
required

Current page number

Example:

1

total
number
required

Total number of items

Example:

1

totalPages
number
required

Total number of pages

Example:

1

Last modified on August 27, 2026