---
title: "returns a list of events that were received for a specific user within a given date range"
method: GET
path: "/dev/events"
tags: ["dev"]
---

# returns a list of events that were received for a specific user within a given date range

`GET /dev/events`

This endpoint allows you to retrieve the events that were captured for a specific user and within
a given date range. A user is identified by the application identifier and the user identifier. You can also
search for only specific type of event using the query parameter eventType. 
There is a restriction on the number of days that your input date range can span which at the moment is set to 7 days.

## Query parameters

- `userId` string, required
- `appId` string, required
- `eventType` string
- `startTime` string
- `endTime` string
- `maxResults` number

## Response `200`

A JSON document that contains the list of events that were found for that user and matching the search criteria.
The list is ordered by the creation date of the events in descending order, i.e. the most recent events appear first.

- GetEventsResponse
  - `events` object[] — A list of events that matched the input search criteria,each event is represented by a JSON object whose schema is customer specific
  - `request` object
    - `userId` string — the identifier of the user for which the events were found
    - `applicationId` string — the identifier of the application in which the user belongs
    - `eventType` string — if a value is set, then only events of this type will be returned
    - `startTime` string, date-time — ISODateTimeType, ISO8601 date format with optional time part. For instance, 1970-01-18T09:19:41.204+0000
    - `endTime` string, date-time — ISODateTimeType, ISO8601 date format with optional time part. For instance, 1970-01-18T09:19:41.204+0000

## Other responses

- `401` — the request was rejected because it concerned an application identifier that doesn't exist in this account.

---

[API](https://skmtc.net/gameanalytics/apis/datatiger-management-api.md) · [All operations](https://skmtc.net/gameanalytics/apis/datatiger-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gameanalytics/datatiger-management-api/revisions/20a4f732a0b7/schema)