GET /v1/events
curl --request GET \
--url https://sandbox.api.prava.space/v1/events \
--header 'Authorization: Bearer <token>'import requests
url = "https://sandbox.api.prava.space/v1/events"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://sandbox.api.prava.space/v1/events', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"events": [
{
"id": "<string>",
"type": "payment.credentials_ready",
"schema_version": "2026-10-08",
"occurred_at": "2023-11-07T05:31:56Z",
"environment": "sandbox",
"account_id": "<string>",
"resource": {
"type": "payment",
"id": "txn_example",
"version": 123
},
"data": {},
"test": true
}
],
"next_cursor": "<string>"
}Events
List Events
Recover retained events in the order Prava recorded them.
GET
/
v1
/
events
GET /v1/events
curl --request GET \
--url https://sandbox.api.prava.space/v1/events \
--header 'Authorization: Bearer <token>'import requests
url = "https://sandbox.api.prava.space/v1/events"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://sandbox.api.prava.space/v1/events', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"events": [
{
"id": "<string>",
"type": "payment.credentials_ready",
"schema_version": "2026-10-08",
"occurred_at": "2023-11-07T05:31:56Z",
"environment": "sandbox",
"account_id": "<string>",
"resource": {
"type": "payment",
"id": "txn_example",
"version": 123
},
"data": {},
"test": true
}
],
"next_cursor": "<string>"
}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
| Filter | Description |
|---|---|
type | One event type, for example payment.failed. |
resource_id | A payment (txn_…), session (ses_…), quote request (qreq_…) or mandate (mdt_…) ID, up to 120 characters. |
from | Inclusive ISO 8601 timestamp with a time zone. |
to | Exclusive ISO 8601 timestamp with a time zone. With from, the range must increase and span at most 30 days. |
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
Your secret key: sk_test_* (sandbox) or sk_live_* (production).
Query Parameters
Return next_cursor unchanged. Events starts at 0; deliveries starts with no cursor.
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 Filter by resource ID
Maximum string length:
120Pattern:
^(txn|ses|qreq|mdt)_[A-Za-z0-9_]+$Inclusive occurrence time
Exclusive occurrence time; increasing paired range at most 30 days