Get Events

Updated on October 2, 2024

If you want to use the events data stored in Releva you can do that with this endpoint:

Request Parameters #

You may perform requests to the API using the following curl equivalent:

curl -H 'Content-Type: application/json' -H 'Authorization: Bearer <secretKey>' -XGET https://releva.ai/api/v0/events

Optional Query Parameters #

FieldTypeDescription
cursorString (Optional)This is used for pagination when you make the first request you will have “nextCursor” inside the response and you can use it to get to the next page.
eventTypesArray[String] (Optional)This is used if you want to filter by specific event types. For example default even types that you can filter by are “pageView”, “cartAdd”, “cartCheckoutSuccess”, etc.
startDateTimeISO-8601 String (Optional)You can specify to get events only after the startDateTime. For example “2023-08-21T21:00:00.000Z” and it has to be escaped in the URL like this “2023-08-21T21%3A00%3A00.000Z”.
endDateTimeISO-8601 String (Optional)You can specify to get events only before the endDateTime. For example “2023-08-29T21:00:00.000Z” and it has to be escaped in the URL like this “2023-08-21T29%3A00%3A00.000Z”.

Example request with all of the parameters in it:

https://releva.ai/api/v0/events?cursor=WyIyMDIzLTA4LTIzVDA4OjU4OjM4LjA5MVoiLCJ3ZWJob29rU2VuZCJd&eventTypes[]=pageView&eventTypes[]=cartAdd&startDateTime=2023-08-21T21%3A00%3A00.000Z&endDateTime=2023-08-29T19%3A30%3A00.000Z

Response Format #

{
  "events": [
        {
            "profileId": "df4ef1f1-5528-b45e-5124-55f6c7268d65",
            "sessionId": "8fcb357c-4831-01df-78d6-4e5c2227c6af",
            "groupAssignment": "treatment",
            "pageToken": "ae94f787-583d-4621-800c-073c8d697c4e",
            "userAgent": {
                "tags": [
                    "Authoritative",
                    "Chrome",
                    "Desktop",
                    "Mac"
                ],
                "browser": "Chrome",
                "version": "115.0.0.0",
                "os": "OS X",
                "platform": "Apple Mac",
                "source": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/115.0.0.0 Safari/537.36"
            },
            "ip": "::ffff:172.20.0.11",
            "action": "pageView",
            "timestamp": "2023-08-04T10:33:37.691Z",
            "url": "http://localhost:8082/product/test-4/",
            "locale": "bg",
            "products": [
                {
                    "categories": null
                }
            ],
            "profile": {
                "firstName": "Georgi",
                "lastName": "Keranov",
                "email": "georgi.keranov@releva.ai",
                "profileId": "a6762904-42e7-a0d4-4e99-df4cb1a4bf44",
                "id": "profile/36/georgi.keranov@releva.ai"
            }
        },
        {
            "cartTotalInDomainCurrency": 26.4,
            "profileId": "1ef6da3a-a3b8-5b42-bce9-af70b8a74bb3",
            "sessionId": "e1abdb6b-b13c-90b5-76df-56d691cff438",
            "groupAssignment": "treatment",
            "userAgent": {
                "tags": [
                    "Authoritative",
                    "Chrome",
                    "Desktop",
                    "Mac"
                ],
                "browser": "Chrome",
                "version": "115.0.0.0",
                "os": "OS X",
                "platform": "Apple Mac",
                "source": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/115.0.0.0 Safari/537.36"
            },
            "ip": "::ffff:172.20.0.11",
            "timestamp": "2023-08-02T13:21:39.289Z",
            "url": "http://localhost:8082/product/test-3/",
            "locale": "bg",
            "action": "cartAdd",
            "products": [
                {
                    "id": "17",
                    "categories": [
                        "Uncategorized"
                    ],
                    "currency": "USD",
                    "locale": "bg",
                    "name": "Test 3",
                    "price": 13.2,
                    "custom": {
                        "string": [
                            {
                                "values": [
                                    "Uncategorized"
                                ],
                                "key": "category_level_1"
                            }
                        ],
                        "numeric": [
                            {
                                "values": [],
                                "key": "stock_quantity"
                            }
                        ]
                    },
                    "discount": 0,
                    "discountPercent": 0,
                    "available": true,
                    "quantity": 2,
                    "priceTotalInDomainCurrency": 26.4,
                    "priceTotal": 26.4
                }
            ],
            "priceTotalInDomainCurrency": 26.4,
            "profile": {
                "firstName": "Petar",
                "lastName": "Ivanov",
                "email": "p.ivanov@example.com",
                "profileId": "1ef6da3a-a3b8-5b42-bce9-af70b8a74bb3",
                "id": "profile/36/p.ivanov@example.com"
            }
        }
        ...
  ],
  "nextCursor": "WyIyMDIzLTA4LTIzVDA4OjU4OjM4LjA5MVoiLCJ3ZWJob29rU2VuZCJd"
}