---
title: "List a list's members"
method: GET
path: "/v1/lists/members"
tags: ["Lists"]
---

# List a list's members

`GET /v1/lists/members`

## Request

- Base URL: `https://api.automatedclientacquisition.com`
- URL: `https://api.automatedclientacquisition.com/v1/lists/members`
- Auth: HTTP bearer

Returns membership rows with a small projection of each contact, so you don't need a second call per member.

## Query parameters

- `listId` string, uuid, required
- `limit` integer
- `cursor` string

## Response `200`

A page of members.

- object
  - `success` boolean
  - `data` ListMember[]
    - `id` string, uuid: Membership row id — this is what the cursor keys on.
    - `contact_id` string, uuid
    - `added_at` string, date-time, nullable
    - `contact` object, nullable: A small projection of the contact, to save a second call.
      - `id` string, uuid
      - `display_name` string
      - `primary_email` string, nullable
      - `company` string, nullable
      - `job_title` string, nullable
  - `has_more` boolean
  - `next_cursor` string, nullable

## Other responses

- `401`: Missing, invalid or revoked token.
- `404`: No such resource in your organization. Returned rather than `403` when the resource exists under a different tenant — cross-tenant existence is not disclosed.

---

[API](https://skmtc.dev/automatedclientacquisition/apis/aca-api.md) · [All operations](https://skmtc.dev/automatedclientacquisition/apis/aca-api/llms.txt) · [OpenAPI document](https://skmtc.dev/automatedclientacquisition/apis/aca-api/revisions/8f3e3b141311?raw)