List user events

Returns events for one user within a specified date range and with optional filters.

This endpoint returns events for a single user within a selected date range.

Provide either id or identifier as query parameter to select the user, and use the request body to define date range, optional filters, and pagination.

Examples

Below you can see several examples of how to use this endpoint to retrieve events from a single user. Further down this page, you can find a detailed reference of all the available options you can pass.

Copy the JSON body of any of these examples, and use it in a POST request to https://api.vemetric.com/v1/users/events?id=123 (or ?identifier=your-user-id) with your API key.

{
  "dateRange": "30days"
}

{
  "dateRange": ["2026-01-01", "2026-01-31"],
  "filters": [
    {
      "type": "event",
      "name": {
        "operator": "eq",
        "value": "DownloadImage"
      }
    }
  ]
}

{
  "dateRange": "30days",
  "limit": 100,
  "offset": 100
}

Be sure to also check out the filter values endpoint to see which values you can use in the filters field.

Headers

Query Parameters

Request Body (required)

Responses