---
title: "Resolve a cohort/repost segment to creator handles"
method: GET
path: "/cohorts/segment"
tags: ["Cohort Analysis"]
---

# Resolve a cohort/repost segment to creator handles

`GET /cohorts/segment`

Resolves a segment — a cohort cell (``source=cohort_cell``) or a repost bucket set (``source=repost``) — to the underlying creator handles, for exporting or piping into outreach. Single-shop only.

## Query parameters

- `source` string, required
- `cohort_month` string, date, nullable — cohort_cell only: cohort start month.
- `offset` integer, nullable — cohort_cell only: month offset.
- `metric` string
- `direction` string
- `buckets` string, nullable — repost only: comma-separated bucket keys.
- `window_days` integer — repost only: recency window.

## Response `200`

Successful Response

- SegmentHandlesResponse — Handles behind a segment, for the create-automation handoff (CORE-6003).
  - `handles` string[]
  - `total` integer — Creators matched by the segment.
  - `resolved` integer — Of those, how many resolved to a handle.
  - `unresolved` integer — Matched creators with no resolvable handle — they cannot go into a creator list. Surfaced so the UI states the real audience size instead of quietly shipping a shorter one.
  - `capped` boolean — True when the segment hit the handle cap.
  - `cap` integer — Max handles returned.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/reacherapp/apis/reacher-data-api.md) · [All operations](https://skmtc.dev/reacherapp/apis/reacher-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/reacherapp/reacher-data-api/revisions/5eefff009b5b/schema)