> ## Documentation Index > Fetch the complete documentation index at: https://docs.spherepay.co/llms.txt > Use this file to discover all available pages before exploring further. # List Events and Their Delivery Status > List events for the authenticated application, with optional filtering by webhook endpoint, event type, delivery status, and creation date range. 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. ## OpenAPI ````yaml openapi/spherepay.yaml GET /v2/events openapi: 3.0.0 info: contact: {} description: The Sphere REST API for payments, transfers, and accounts. title: Sphere API version: '2' servers: - description: Production url: https://api.spherepay.co security: - bearer: [] tags: [] paths: /v2/events: get: summary: List Events V2 description: >- List events for the authenticated application, with optional filtering by webhook endpoint, event type, delivery status, and creation date range. operationId: getV2Events parameters: - in: query name: '' required: true schema: properties: createdEnd: description: ISO 8601 upper bound on event creation time (inclusive). example: '2026-12-31T23:59:59Z' format: date-time type: string createdStart: description: ISO 8601 lower bound on event creation time (inclusive). example: '2026-01-01T00:00:00Z' format: date-time type: string limit: default: '10' description: 'Number of items per page (default: 10)' example: 10 type: string page: default: '1' description: 'Page number of the list (default: 1)' example: 1 type: string status: description: Filter to events whose delivery is in this status. enum: - queued - delivering - delivered - failed example: delivered type: string x-enumNames: - QUEUED - DELIVERING - DELIVERED - FAILED type: description: >- Filter by event type. Supports wildcard suffix (e.g. "payment.*" matches all payment events). example: payment.* type: string webhookEndpointId: description: >- Filter to events that have a delivery for this webhook endpoint. example: webhook_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6 type: string required: - page - limit type: object responses: '200': content: application/json: schema: properties: data: description: Array of event presentations items: properties: createdAt: description: ISO 8601 timestamp when the event was created. example: '2026-01-01T00:00:00.000Z' type: string delivery: description: >- The most recent delivery for this event, or the one matching the webhookEndpointId/status filter if provided. Null if this event has no deliveries. nullable: true properties: attemptsUsed: description: Number of delivery attempts made so far. example: 1 type: number deliveredAt: description: >- ISO 8601 timestamp when the event was successfully delivered, or null if not yet delivered. example: '2026-01-01T00:05:00.000Z' nullable: true type: string id: description: The unique identifier of the delivery. example: eventDelivery_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6 type: string latestAttempt: description: >- The most recent delivery attempt for this delivery, or null if no attempt has been made yet. nullable: true properties: responseCode: description: >- HTTP status code returned by the endpoint, or null if no response was received. example: 200 nullable: true type: number success: description: >- Whether this attempt was delivered successfully. example: true type: boolean type: description: The kind of delivery attempt. enum: - original - replay - retry example: original type: string x-enumNames: - ORIGINAL - REPLAY - RETRY required: - type - success - responseCode type: object status: description: The current status of this delivery. enum: - queued - delivering - delivered - failed example: delivered type: string x-enumNames: - QUEUED - DELIVERING - DELIVERED - FAILED webhookEndpointId: description: >- The unique identifier of the webhook endpoint this delivery targets. example: webhook_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6 type: string required: - id - webhookEndpointId - status - attemptsUsed - deliveredAt - latestAttempt type: object id: description: The unique identifier of the event. example: event_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6 type: string sequence: description: >- Monotonically increasing sequence number for ordering events, or null if not assigned. example: 3 nullable: true type: number type: description: The type of the event. enum: - '*' - customer.* - transfer.* - document.* - service.* - customer.created - customer.pending - customer.approved - customer.rejected - transfer.created - transfer.pendingFunding - transfer.pendingReview - transfer.fundsReceived - transfer.processing - transfer.succeeded - transfer.returned - transfer.pendingRefundInformation - transfer.failed - transfer.canceled - transfer.refunded - transfer.unexpectedError - transfer.failedPrecondition - transfer.expired - transfer.unfunded - document.pending - document.processing - document.verified - document.rejected - service.pending - service.processing - service.succeeded - service.failed - service.cancelled example: transfer.succeeded type: string x-enumNames: - ALL - ALL_CUSTOMER - ALL_TRANSFER - ALL_DOCUMENT - ALL_SERVICE - CREATE_CUSTOMER - PENDING_CUSTOMER - APPROVE_CUSTOMER - REJECT_CUSTOMER - CREATE_TRANSFER - PENDING_FUNDING_TRANSFER - PENDING_REVIEW_TRANSFER - FUNDS_RECEIVED_TRANSFER - PROCESSING_TRANSFER - SUCCESSFUL_TRANSFER - RETURNED_TRANSFER - PENDING_REFUND_INFORMATION_TRANSFER - FAILED_TRANSFER - CANCELLED_TRANSFER - REFUNDED_TRANSFER - UNEXPECTED_ERROR_TRANSFER - FAILED_PRECONDITION_TRANSFER - EXPIRED_TRANSFER - UNFUNDED_TRANSFER - PENDING_DOCUMENT - PROCESSING_DOCUMENT - VERIFIED_DOCUMENT - REJECTED_DOCUMENT - PENDING_SERVICE - PROCESSING_SERVICE - SUCCESSFUL_SERVICE - FAILED_SERVICE - CANCELLED_SERVICE required: - id - type - createdAt - sequence - delivery type: object type: array hasNext: description: Whether there is a next page example: false type: boolean hasPrevious: description: Whether there is a previous page example: false type: boolean limit: description: Number of items per page example: 10 exclusiveMaximum: false exclusiveMinimum: false maximum: 100 minimum: 1 type: number page: description: Current page number example: 1 type: number total: description: Total number of items example: 1 type: number totalPages: description: Total number of pages example: 1 type: number required: - page - limit - total - totalPages - hasNext - hasPrevious - data type: object description: A paginated list of events. '400': content: application/json: examples: Bad Request: summary: Bad Request value: code: address/invalid correlationId: 28c61e885c6e5eaa78c1a2183a9b883c detail: Invalid request parameters status: 400 schema: $ref: '#/components/schemas/ProblemDetailsDto' description: Bad Request '404': content: application/json: examples: Not Found: summary: Not Found value: code: resource/not-found correlationId: 28c61e885c6e5eaa78c1a2183a9b883c detail: Resource not found status: 404 schema: $ref: '#/components/schemas/ProblemDetailsDto' description: Not Found '422': content: application/json: examples: Validation Error: summary: Validation Error value: code: validation/failed correlationId: 28c61e885c6e5eaa78c1a2183a9b883c detail: Validation failed errors: - detail: Invalid email format pointer: /email - detail: Name is required pointer: /name status: 422 schema: $ref: '#/components/schemas/ProblemDetailsDto' description: Unprocessable Entity - Validation Error components: schemas: ProblemDetailsDto: properties: code: type: string correlationId: type: string detail: type: string errors: items: properties: detail: type: string header: type: string parameter: type: string pointer: type: string required: - detail type: object type: array status: type: integer title: type: string required: - status - detail type: object securitySchemes: bearer: bearerFormat: JWT scheme: bearer type: http ````