01 List Events

List All Events #

Retrieves a list of events. Requires a valid session token and the permissions.events.list permission.

Endpoint # 

GET https://api.tracx.events/v1/connect/events

Headers # 

{
  "Accept": "application/json",
  "Authorization": "<connect-token>"
}

Example cURL Request # 

curl --request POST \
  --url https://api.tracx.events/v1/connect/events \
  --header 'Accept: application/json' \
  --header 'Authorization: <connect-token>'

Sample Response # 

{
    "data": {
        "items": [
            {
                "id": 1,
                "name": "Event name 1",
                "created_at": "2025-02-25 09:45:32",
                "updated_at": "2025-02-25 09:45:32"
            },
            {
                "id": 2,
                "name": "Event name 2",
                "created_at": "2025-02-25 10:59:46",
                "updated_at": "2025-02-25 11:25:52"
            }
        ]
    }
}

Response Fields #

Field Type Description
data.items array List of all events
id int Unique identifier of the event
name string Name of the event
created_at string Timestamp when the event was created (YYYY-MM-DD HH:MM:SS)
updated_at string Timestamp when the event was last updated (YYYY-MM-DD HH:MM:SS)

Error Handling #

Status Code Meaning
200 OK Request was successful
401 Unauthorized Missing or invalid authentication token
403 Forbidden Session Token does not have the required permission

Notes #

  • The request must include a valid session token.
  • The session token must have the permissions.events.list permission.
  • The response contains an array of event objects.