---
title: "List segments"
description: "Your saved segments, each with the number of people in it right now (segments are evaluated on every read, never materialized), plus presets you can save as a starting point. Pass a segment id to GET /v1/people to list its members."
canonical: https://docs.mentio.dev/api/segments/list-segments
markdown: https://docs.mentio.dev/api/segments/list-segments.mdx
---

# List segments

`GET /v1/segments`

Your saved segments, each with the number of people in it right now (segments are evaluated on every read, never materialized), plus presets you can save as a starting point. Pass a segment id to GET /v1/people to list its members.

## Responses

- 200: Every segment, with presets
- 401: Missing or invalid API key

Full schemas: https://api.mentio.dev/v1/openapi.json. Conventions: https://docs.mentio.dev/conventions.mdx