---
title: "List segments"
description: "Returns your saved segments with the current number of people in each, plus presets you can save as a start. Segments are counted on each read and never stored as lists. To see who is in one, send its id to GET /v1/people."
canonical: https://docs.rumoro.dev/api/segments/list-segments
markdown: https://docs.rumoro.dev/api/segments/list-segments.mdx
---

# List segments

`GET /v1/segments`

Returns your saved segments with the current number of people in each, plus presets you can save as a start. Segments are counted on each read and never stored as lists. To see who is in one, send its id to GET /v1/people.

## Responses

| Status | Meaning |
| --- | --- |
| 200 | All segments and the presets |
| 401 | The API key is missing or not valid |

The [OpenAPI document](https://api.rumoro.dev/v1/openapi.json) has every schema. Rules shared by all endpoints are in [Conventions](https://docs.rumoro.dev/conventions.mdx).