Events API
Get Events
Get events based on a query
GET
This endpoint requires your private API key.
Query Parameters
The event name to filter by.
Example:
"Created Account"
The UUID to filter by.
Example:
"123e4567-e89b-12d3-a456-426614174000"
The user ID to filter by.
Example:
"user-123"
The group ID to filter by.
Example:
"group-456"
The anonymous ID to filter by.
Example:
"anon-789"
The instance ID to filter by.
Example:
"instance-101112"
The start date to filter by.
Example:
"2022-01-01T00:00:00Z"
The end date to filter by.
Example:
"2022-12-31T23:59:59Z"
The limit of records to return.
Example:
100
The offset of records to return.
Example:
0
The field to order by.
Example:
"timestamp"
The direction to order by.
Available options:
ASC
, DESC
Example:
"ASC"
Response
200 - application/json
The events have been successfully retrieved.
The limit of the pagination.
The offset of the pagination.
The total number of results. If null
, the total is unknown.
The events found based on the query.
Example:
[
{
"uuid": "123",
"type": "track",
"event": "user_signed_up",
"userId": "user-123",
"groupId": "group-456",
"anonymousId": "anon-789",
"instanceId": "instance-101112",
"properties": { "key": "value" }
}
]
Was this page helpful?