# GET /lists

Part of the SendHeron REST API. Base URL: `https://api.sendheron.com/api/v1`

List lists and segments with pagination and filtering.

```http
GET https://api.sendheron.com/api/v1/lists
Authorization: Bearer <YOUR_API_KEY>
```

**Required scopes:** `contacts:read`

**Success status:** `200`

**Rate limit:** 100/min per key, counted against the organization's READ ceiling (1200/min).

**Query parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `page` | integer | no | Zero-based page number. Defaults to `0`. The answer is the [list envelope](/docs#pagination). |
| `limit` | integer | no | Items per page, from 1 to 100. Defaults to `50`. |
| `term` | string | no | Partial match on the list name. |
| `type` | STATIC \| DYNAMIC | no | Filter by list type. |

> Member counts are not included here; read one list for its count.


---

Rate limits: 100/min per key, counted against the organization's READ ceiling (1200/min). Both windows are one minute.
