# List segments (/es/api-reference/segments/listSegments)

`GET /v1/segments`

Base URL: `https://api.bitelio.com`

Get all audience segments

---

**Path versioning.** This resource is also reachable at the unversioned `/segments`, which is where it has always lived and which keeps working indefinitely — `bitelio@0.1.0` calls it. Prefer `/v1/segments`: the `/v1` prefix is the path that carries a version promise, and a future `/v2` will be able to change shape without breaking anything written against this one.

## Responses

### `200` — List of segments

- items: object
  - `id`: string
  - `name`: string
  - `filters`: object
  - `trackMembership`: boolean
  - `memberCount`: integer

```json
[
  {
    "id": "string",
    "name": "string",
    "filters": null,
    "trackMembership": false,
    "memberCount": 0
  }
]
```

## Example request

```bash
curl -X GET 'https://api.bitelio.com/v1/segments' \
  -H 'Authorization: Bearer YOUR_API_KEY'
```