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

# Lists

> Read your campaign's saved voter lists (coming soon).

<Warning>
  **Coming soon.** These endpoints are planned but not yet active. The shapes below may change before
  launch. Today only the [Walks](/api-reference/walks) endpoints are live.
</Warning>

**Lists** are saved sets of voters — from a search query, an area selection, or an uploaded file.
The read API will let you pull a list's voters into your own tools.

## Planned endpoints

```http theme={null}
GET /api/v1/lists
GET /api/v1/lists/{id}
```

### List lists — planned response

<ResponseField name="id" type="string">The list's unique id.</ResponseField>
<ResponseField name="name" type="string">List name.</ResponseField>
<ResponseField name="count" type="integer">Number of voters in the list.</ResponseField>
<ResponseField name="source" type="string">How it was built — `query`, `area`, or `upload`.</ResponseField>
<ResponseField name="created_at" type="string">ISO-8601 timestamp.</ResponseField>

### Get a list — planned response

Returns the list plus its voters (id, name, address, precinct — final field set TBD). Large lists
will be paginated with `?limit` and a cursor.

Requires the `lists:read` scope. Want early access? Let the Culper team know.