---
title: "GET /v0.1/apps/{owner_name}/{app_name}/analytics/events"
method: GET
path: "/v0.1/apps/{owner_name}/{app_name}/analytics/events"
tags: ["analytics"]
---

# GET /v0.1/apps/{owner_name}/{app_name}/analytics/events

`GET /v0.1/apps/{owner_name}/{app_name}/analytics/events`

## Request

- Base URL: `https://api.appcenter.ms`
- URL: `https://api.appcenter.ms/v0.1/apps/{owner_name}/{app_name}/analytics/events`
- Auth: API key in header `X-API-Token`
- TypeScript: <https://skmtc.dev/appcenter/apis/app-center-client/docs/v0.1/apps/:owner_name/:app_name/analytics/events/get.ts> (a function with typed inputs; its response is checked against the schema)

Count of active events in the time range ordered by event.

## Path parameters

- `owner_name` string, required
- `app_name` string, required

## Query parameters

- `start` string, date-time, required
- `end` string, date-time
- `versions` string[]
- `event_name` string[]
- `$top` integer
- `$skip` integer
- `$inlinecount` 'allpages' | 'none'
- `$orderby` string

## Response `200`

Count of active events in the time range ordered by event.

- object
  - `events` object[]
    - `id` string, string
    - `name` string, string
    - `device_count` integer
    - `previous_device_count` integer: The device count of previous time range of the event.
    - `count` integer
    - `previous_count` integer: The event count of previous time range of the event.
    - `count_per_device` number, double
    - `count_per_session` number, double
  - `total` integer: The total count of events.
  - `total_devices` integer: The active device over this period.

## Other responses

- `default`: Error code with reason.

---

[API](https://skmtc.dev/appcenter/apis/app-center-client.md) - [All operations](https://skmtc.dev/appcenter/apis/app-center-client/llms.txt) - [OpenAPI document](https://skmtc.dev/appcenter/apis/app-center-client/revisions/4e9226ab8f35?raw)
