# GET /lists/{id}

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

Get a single list by ID, with its member count.

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

> `contactCount` is counted at read time: the members of a static list, or the contacts a dynamic list matches right now.


---

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