---
title: "Event segmentation"
method: GET
path: "/api/2/events/segmentation"
tags: ["Analytics"]
---

# Event segmentation

`GET /api/2/events/segmentation`

## Request

- Base URL: `https://amplitude.com`
- URL: `https://amplitude.com/api/2/events/segmentation`
- Auth: HTTP basic

Return metrics for one or two events over a date range, optionally segmented and grouped. URL-encode special characters in event types and property names.

## Query parameters

- `e` string, required
- `e2` string
- `start` string, required
- `end` string, required
- `m` 'uniques' | 'totals' | 'pct_dau' | 'average' | 'histogram' | 'sums' | 'value_avg'
- `i` integer
- `s` string
- `g` string
- `limit` integer

## Response `200`

Series data with labels and per-series values.

- object

## Other responses

- `400`: Invalid request. Check that JSON query parameters are well formed and that special characters are URL encoded.
- `401`: Missing or invalid credentials. Send HTTP Basic auth with the project API key as the username and the secret key as the password.
- `429`: Concurrent or hourly rate limit exceeded for the project. The response identifies which limit was hit. Up to 5 concurrent requests are allowed across Amplitude REST endpoints.

## Changes

- **2026-10-14** `e475ad97669a`: 3 info
  - added the media type `*/*` for the response with the status `400`
  - added the media type `*/*` for the response with the status `401`
  - added the media type `*/*` for the response with the status `429`

[Operation history](https://skmtc.dev/amplitude/apis/amplitude-public-apis/changes/api/2/events/segmentation/get.md)

---

[API](https://skmtc.dev/amplitude/apis/amplitude-public-apis.md) - [All operations](https://skmtc.dev/amplitude/apis/amplitude-public-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/amplitude/apis/amplitude-public-apis/revisions/e475ad97669a?raw)