# GET /lists/{id}/contacts

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

List the contacts in a list.

```http
GET https://api.sendheron.com/api/v1/lists/{id}/contacts
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).

**Path parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | uuid | yes | List UUID. |

**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 email, first name or last name. |

> The members of a static list, or the contacts a dynamic list matches right now, newest first. Each is the same record `GET /contacts/{id}` answers.


---

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