---
title: "Segmentation"
method: GET
path: "/api/admin/segmentation"
tags: ["admin"]
---

# Segmentation

`GET /api/admin/segmentation`

User + paying-user distribution across institution tier / type / name.

Answers "who actually uses this, and who pays" — segmented by the derived
`users.institution_*` columns (app/institutions.py) and scoped to one
research domain, since a humanities Pro and an omics Pro are different
businesses.

`paid` counts users with an active PAID subscription in `domain`. Free
grants (promo/trial/admin) are reported separately as `granted` and are
never folded into `paid` — the 2026-07 humanities promo would otherwise
make every tier look like it converts at 97%.

`unresolved` lists the most common institution strings the reference table
doesn't recognise yet — the work queue for growing `institutions.json`.

## Query parameters

- `domain` string
- `limit` integer

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- object

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/omicos/apis/omicos-server.md) · [All operations](https://skmtc.dev/omicos/apis/omicos-server/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/omicos/omicos-server/revisions/a00b94573ffe/schema)