Skip to main content
GET
/
events
List events
curl --request GET \
  --url https://api.zopay.cash/connect/v1/events \
  --header 'Authorization: Bearer <token>'
{
  "has_more": true,
  "data": [
    {
      "id": "<string>",
      "object": "<string>",
      "type": "<string>",
      "livemode": true,
      "api_version": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "data": {},
      "related_to": "<string>",
      "related_to_kind": "<string>"
    }
  ],
  "cursor": "<string>"
}
Devuelve los eventos del log canónico, más recientes primero. Es la superficie pull de la entrega de eventos; los webhooks son la superficie push de los mismos datos. Concepto y diagrama en Events.

Authorizations

​
Authorization
string
header
required

Paste your Connect API key (sk_live_… for production, sk_test_… for sandbox) without the Bearer prefix. Mint and rotate keys from the admin panel.

Headers

​
authorization
string | null

Query Parameters

​
type
string | null

Comma-separated list of event types to include. v1 vocabulary: payment_intent.completed, address.deposit.received. Unknown values return 400 invalid_type.

​
related_to
string | null

UUID of the principal object the event is about. Useful for show me every event for this intent; pass the intent id (or future address id, etc.) here. Single-value -- to query across N principals make N requests.

​
livemode
string | null

true / false / omit. Filters by the event's livemode column verbatim. Omit to include both modes.

​
from
string | null

Inclusive lower bound on created_at (ISO 8601 date or datetime; naive input is treated as UTC).

​
to
string | null

Inclusive upper bound on created_at (ISO 8601 date or datetime; naive input is treated as UTC).

​
cursor
string | null

Opaque continuation token from a previous response's cursor field. Omit to fetch the first page.

​
limit
integer
default:50

Max rows to return (server clamps at 200).

Required range: 1 <= x <= 200

Response

Successful Response

Paginated list response, same envelope as the other Connect " list endpoints.

​
has_more
boolean
required

True iff at least one more row exists past this page. Computed by fetching limit + 1 rows server-side; if the SQL returns limit + 1, we slice to limit and set has_more=True.

​
data
ConnectEventLine · object[]
​
cursor
string | null

Opaque continuation token. Pass back as ?cursor=... to fetch the next page; None on the last page.