Skip to content
Docs
APISign inStart free

List a connection's webhook events

The processor_connections.events.list operation: GET /api/v1/processor_connections/{id}/events in the REST API and the processor_connections_events_list tool in the MCP server.

GET/api/v1/processor_connections/{id}/events

Lists the verified webhook events a processor connection received, newest first: the processor's event ID and type, what Ownrecord made of it (normalizedKind), its status (pending, processed, failed with the error) and the handlers that ran. Events with a bad signature are refused at the door and never listed. The processor's payload isn't returned. Paginate with limit and starting_after.

At a glance

  • REST: GET /api/v1/processor_connections/{id}/events
  • MCP tool: processor_connections_events_list
  • Operation ID: processor_connections.events.list
  • Scope: Legal entity
  • Permission: processors:read
  • Risk tier: read
  • Dry run: Not supported
  • Idempotency: Not needed (read only)
  • Modes: Test and live
  • Pagination: limit (at most 100) and starting_after
  • Authentication: API key with the processors:read scope
  • Since: M4

Request

Path parameters

FieldTypeDescription
idpcon_… ID

Query parameters

FieldTypeRequiredDescription
limitinteger (1 to 100)No
starting_afterpevt_… IDNo

Response

200 OK with a JSON object, a page of the list (newest first):

FieldTypeDescription
object"list"
dataarray of object
data[].idpevt_… ID
data[].object"processor_event"
data[].connectionIdpcon_… ID
data[].processorone of stripe, mollie, fake
data[].externalEventIdstring
data[].typestring
data[].normalizedKindstring or null
data[].statusone of pending, processed, failed
data[].attemptsinteger (at least 0)
data[].handlersarray of string
data[].errorobject or null
data[].receivedAtdate-time
data[].processedAtdate-time or null
has_moreboolean
next_cursorpevt_… ID or null

Examples

Recent events

HTTP
GET /api/v1/processor_connections/pcon_01m4vyt4mxe0s9zzk90373z6p6/events?limit=20
Authorization: Bearer or_test_…

Response (200):

JSON
{
  "object": "list",
  "data": [
    {
      "id": "pevt_01m4vyt4mxe0s9zzk90373z6p8",
      "object": "processor_event",
      "connectionId": "pcon_01m4vyt4mxe0s9zzk90373z6p6",
      "processor": "stripe",
      "externalEventId": "evt_3ExampleEvent0001",
      "type": "payment_intent.succeeded",
      "normalizedKind": "payment.succeeded",
      "status": "processed",
      "attempts": 1,
      "handlers": [],
      "error": null,
      "receivedAt": "2026-10-14T12:05:00.000Z",
      "processedAt": "2026-10-14T12:05:00.000Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Errors

CodeHTTP statusWhenWhat to do
resource_not_found404No such connection for this entity in this mode.Check the ID and that your credentials are scoped to the right organization, entity, brand and mode.
validation_failed400A pagination value is invalid.Fix the fields listed in details.issues and send the request again.
scope_required400The request names no legal entity.Call the operation with credentials or a target at its level: an organization, a legal entity, a brand or the platform (details.required_scope).
permission_denied403You can't see processor connections here.Ask an organization owner or admin for a role or scope that allows this action.

It can also return these common errors: api_version_unsupported, authentication_required, api_key_invalid, dry_run_not_supported, rate_limited, internal_error.