List events
- Path
/events- Auth
- Secret key · server only
const url = 'https://releva.ai/api/v0/events?eventTypes%5B%5D=wishlistAdd&eventTypes%5B%5D=search&startDateTime=2026-10-21T00%3A00%3A00Z&endDateTime=2026-10-22T00%3A00%3A00Z';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://releva.ai/api/v0/events?eventTypes%5B%5D=wishlistAdd&eventTypes%5B%5D=search&startDateTime=2026-10-21T00%3A00%3A00Z&endDateTime=2026-10-22T00%3A00%3A00Z' \ --header 'Authorization: Bearer <token>'Returns the domain’s tracked events from every source (SDK, server events, searches, subscriptions, carts),
newest first, 10 per page. nextCursor is present only when the page holds 10 events.
Known issue (verified 2026-10-21): events inside a page are not sorted and the cursor is taken from the last
element of the page, so consecutive pages can repeat or skip events. De-duplicate on the client.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Query Parameters
Section titled “Query Parameters”Filter on action. Repeat the parameter (eventTypes[]=a&eventTypes[]=b). A plain eventTypes=a is rejected.
Example
?eventTypes%5B%5D=wishlistAdd&eventTypes%5B%5D=searchISO-8601 date-time with seconds and a timezone offset (Z, +0300 or +03:00), optional milliseconds.
Inclusive lower bound. URL-encode : and + (%2B).
Example
2026-10-21T00:00:00ZISO-8601 date-time with seconds and a timezone offset (Z, +0300 or +03:00), optional milliseconds.
Exclusive upper bound.
Example
2026-10-22T00:00:00ZThe nextCursor of the previous page. Any other value answers 500.
Responses
Section titled “Responses”One page of events.
object
An event as stored. Empty values are omitted. Browser events also carry sessionId, deviceId, pageToken, groupAssignment, ip and url.
object
profile/<domainId>/<profile id>.
Same value as profileId.
[longitude, latitude].
object
Custom attributes, usable in segments.
object
object
object
object
Search events only. The filter object serialised as JSON.
UTC, YYYY-MM-DD HH:mm:ss.SSS.
object
The profile row (about 40 fields, including e-mail, phone, names, tags, subscriptions and bounce dates). Absent when the profile no longer exists.
object
Present only when the page has 10 events.
Example
{ "events": [ { "userAgent": {}, "profileId": "profile/15/DEMO-CUST-1001", "domainId": "15", "action": "wishlistAdd", "timestamp": "2026-10-21T09:15:00.000Z", "locale": "en", "location": [ 0, 0 ], "tags": [ "wishlist" ], "products": [ { "available": true, "categories": [ "Men/Shirts", "Summer" ], "currency": "EUR", "id": "DEMO-1001", "locale": "en", "name": "Linen Summer Shirt", "price": 39.9, "priceTotalInDomainCurrency": 39.9, "quantity": 1, "sku": "DEMO-1001-M", "custom": { "string": [ { "key": "size", "values": [ "M" ] }, { "key": "brand", "values": [ "Demo Basics" ] } ], "numeric": [], "date": [] } } ], "cartTotalInDomainCurrency": 39.9, "ingestedAt": "2026-10-20 21:56:43.000", "custom": { "string": [ { "key": "source", "values": [ "product-page" ] } ], "numeric": [ { "key": "position", "values": [ 2 ] } ], "date": [] }, "profile": { "domainId": "15", "firstName": "Maria", "lastName": "Example", "email": "maria@example.com", "id": "profile/15/DEMO-CUST-1001" }, "id": "profile/15/DEMO-CUST-1001" } ]}Authentication or query validation error.
object
Human-readable error. Several validation errors are joined with a space.
Examples
{ "message": "The 'eventTypes' field must be an array."}{ "message": "startDateTime must be a valid ISO-8601 date including seconds and timezone offset with optional milliseconds such as 2020-01-01T23:59:59.999Z or 2020-01-01T23:59:59.999-0500 or 2020-01-01T23:59:59-0500. Got 2026-10-21 instead."}{ "message": "Authorization header is missing."}The domain is disabled.
object
Human-readable error. Several validation errors are joined with a space.
Example
{ "message": "Domain is disabled. Please reach out to support@releva.ai to enable it."}Unexpected server error.
object
Human-readable error. Several validation errors are joined with a space.
Example
{ "message": "An internal error occurred."}