---
title: "Today's Top Events"
method: GET
path: "/events/top"
tags: ["Event Breakdown"]
---

# Today's Top Events

`GET /events/top`

Get the top events for today, with their counts and the normalized percent change from yesterday.
The Query API has a rate limit of 60 queries per hour and a maximum of 5 concurrent queries.

## Query parameters

- `project_id` integer, required
- `workspace_id` integer
- `type` 'general' | 'unique' | 'average', required
- `limit` integer

## Response `200`

Success.

- object
  - `events` object[]
    - `amount` integer — Number of events
    - `event` string — The name of the event
    - `percent_change` number, float — The percent change from yesterday
  - `type` string

---

[API](https://skmtc.net/mixpanel/apis/query-api.md) · [All operations](https://skmtc.net/mixpanel/apis/query-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mixpanel/query-api/revisions/f442da95252a/schema)