> ## Documentation Index
> Fetch the complete documentation index at: https://docs.recotap.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Segments

> Pull all active and draft static segments from Recotap

`GET /segments`

Returns all active and draft static segments for your team. Only static segments are exposed via the External API. Supports keyset-based pagination.

```bash theme={null}
curl "https://eapi.recotap.com/api/v1/segments?limit=100" \
  -H "X-Api-Key: your-api-key-here"
```

**Query parameters**

| Parameter | Type    | Description                                                                                   |
| --------- | ------- | --------------------------------------------------------------------------------------------- |
| `limit`   | integer | Number of records to return. Default `100`.                                                   |
| `cursor`  | string  | Keyset cursor. Pass the `nextCursor` value from the previous response to fetch the next page. |

**Response `data`**

```json theme={null}
{
  "data": [
    { "segmentId": "seg-001", "name": "Q2 Target Accounts", "status": "active" },
    { "segmentId": "seg-002", "name": "Draft Campaign List", "status": "draft" }
  ],
  "nextCursor": "seg-001",
  "hasNextPage": false
}
```

| Field         | Description                                                             |
| ------------- | ----------------------------------------------------------------------- |
| `nextCursor`  | Pass this value as `cursor` on the next request to fetch the next page. |
| `hasNextPage` | `true` if more records exist beyond the current page.                   |

**Segment fields**

| Field       | Description                                                                                                 |
| ----------- | ----------------------------------------------------------------------------------------------------------- |
| `segmentId` | Recotap's segment ID. Pass this as `segmentId` when calling [Create Accounts](../accounts/create-accounts). |
| `name`      | Display name of the segment                                                                                 |
| `status`    | `active` or `draft`                                                                                         |