Events
Retrieve an event
Returns an event of your store in the environment of the key, if it happened in the last 30 days.
GET
/v1/events/{event_id}Requires the events:read scope.
curl https://api.rais.app/v1/events/evt_Qm9dMhJ0k8s2Wv7Yc3XnLpAb \
-H "Authorization: Bearer rais_sk_test_..."Response200
{
"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"
}
}
}Request
Path parameters
event_idstringrequiredThe id of the event (evt_...).
At most 100 characters.
Response
200The event.
Returns the Event object.
Errors
| Status | Code | Example message |
|---|---|---|
| 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. |
| 404 | event_not_found | No such event. |
| 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.