---
title: "Get Segment Leaderboard"
method: GET
path: "/api/v1/rankings/{ranking_id}/segment-leaderboard"
tags: ["Rankings"]
---

# Get Segment Leaderboard

`GET /api/v1/rankings/{ranking_id}/segment-leaderboard`

## Request

- Base URL: `https://app.aimrank.io` (the document declares no server; this is the origin it was published from)
- URL: `https://app.aimrank.io/api/v1/rankings/{ranking_id}/segment-leaderboard`
- Auth: none declared

Leaderboard filtered by voter demographic segment.

Marketing-agency wedge: "in the 25-34 women segment, which creative
won?" — computes per-entity wins/losses across votes whose
`voter_segment` matches every key/value in the requested filter.

Without filters, returns the same per-entity vote tally derived from
Vote rows (not the stored mu/phi) so callers can compare apples to
apples with the segmented case. The stored mu/phi on Entity still
reflect ALL votes — this endpoint is for slice analysis, not the
canonical ranking.

## Path parameters

- `ranking_id` string, required

## Query parameters

- `segment` string[]: Filter by voter segment, repeat per axis: ?segment=age_group:25-34&segment=gender:female
- `limit` integer

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/aimrank/apis/aimrank-api.md) · [All operations](https://skmtc.dev/aimrank/apis/aimrank-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aimrank/apis/aimrank-api/revisions/3574d0aff459?raw)