Events
List events
Returns the events of your store in the environment of the key from the last 30 days, newest first.
/v1/eventsRequires the events:read scope.
Filter with type (for instance payment.succeeded); page with starting_after.
curl 'https://api.rais.app/v1/events?type=payment.succeeded&limit=3' \
-H "Authorization: Bearer rais_sk_test_..."{
"object": "list",
"data": [
{
"id": "evt_Qm9dMhJ0k8s2Wv7Yc3XnLpAb",
"object": "event",
"api_version": "2026-10-26",
"created": 1793000300,
"livemode": false,
"type": "payment.succeeded",
"data": {
"object": {
"id": "5b1c2f4e-9d3a-4c61-8a7e-0f2d6b9e1a33",
"object": "payment",
"status": "paid",
"amount": 500000,
"currency": "DZD"
}
}
}
],
"has_more": false,
"next_cursor": null
}Request
Query parameters
typestringOnly events of this type: payment.succeeded, payment.failed, payment.cancelled, payment.reversed, refund.succeeded or refund.failed.
At most 64 characters.
limitintegerHow many objects to return: 1 to 100 (default 20).
Between 1 and 100. Default 20.
starting_afterstringThe cursor of the page to return: pass the next_cursor of the previous page (the id of its last object).
At most 100 characters.
Response
200A page of events.
objectstringAlways list.
Always list.
dataarray of EventThe events of this page, newest first.
has_morebooleanTrue when there are older events.
next_cursorstringnullableThe value to pass as starting_after for the next page; null on the last page.
Errors
| Status | Code | Example message |
|---|---|---|
| 400 | invalid_parameter | Invalid value. |
| 400 | invalid_cursor | No such payment: the starting_after cursor is unknown. |
| 401 | invalid_api_key | Invalid API key provided. |
| 403 | insufficient_scope | This API key does not have the 'payments:write' permission. |
| 403 | account_disabled | This store is suspended or disabled. |
| 403 | live_mode_not_enabled | Complete business verification to take live payments. |
| 429 | rate_limit_exceeded | Too many requests. Slow down and retry after the delay in the Retry-After header. |
| 500 | internal_error | Something went wrong on our side. Quote the request id to support. |
Every error has the same envelope. See Errors.