Skip to main content
GET
GET /v1/events
Returns up to 50 events per page, oldest first, in the order Prava recorded them. Use it to recover events your receiver missed. Events are kept for 30 days. Keep the same filters while you pass next_cursor as cursor. Events are scoped to the application and environment of your secret key. Queued test events are included, with "test": true.

Authorizations

Authorization
string
header
required

Your secret key: sk_test_* (sandbox) or sk_live_* (production).

Query Parameters

cursor
string

Return next_cursor unchanged. Events starts at 0; deliveries starts with no cursor.

type
enum<string>

Filter by event type

Available options:
payment.credentials_ready,
payment.succeeded,
payment.failed,
card_enrollment.completed,
card_enrollment.failed,
card_enrollment.cancelled,
card_enrollment.expired,
mandate.created,
mandate.creation_failed,
mandate.creation_cancelled,
mandate.creation_expired,
mandate.paused,
mandate.resumed,
mandate.cancelled,
mandate.expired,
quote.request_failed
resource_id
string

Filter by resource ID

Maximum string length: 120
Pattern: ^(txn|ses|qreq|mdt)_[A-Za-z0-9_]+$
from
string<date-time>

Inclusive occurrence time

to
string<date-time>

Exclusive occurrence time; increasing paired range at most 30 days

Response

Successful operation; endpoints never include stored signing secrets.

events
object[]
required

In the order Prava recorded them, oldest first.

Maximum array length: 50
next_cursor
string | null
required

Pass as cursor for the next page. null on the last page.