---
title: "List supported native saved people lists"
method: GET
path: "/crm/saved-lists"
---

# List supported native saved people lists

`GET /crm/saved-lists`

## Request

- Base URL: `https://api.bamf.ai/v1`
- URL: `https://api.bamf.ai/v1/crm/saved-lists`
- Auth: HTTP bearer

Requires a BAMF user JWT; API keys and OAuth credentials are rejected. agent_sessions:read public admission and downstream client.crm.read workspace capability are required. Client ownership is resolved by the server. Returns up to the first 100 combined saved master-contact lists, supported CRM system segments, and receipt-verified reviewed CRM lead lists; unmarked manual CRM lists and company/unknown domains are omitted. coverage.complete is always false.

## Query parameters

- `workspace_id` string, uuid, required

## Response `200`

Read-only bounded catalog; no provider calls.

- object
  - `workspace_id` string, uuid, required
  - `read_only` unknown, required
  - `provider_mutation` unknown, required
  - `lists` object[], required
    - `id` string, uuid, required
    - `name` string, required
    - `member_kind` 'master_contacts' | 'crm_leads', required
    - `count` integer, required
  - `coverage` object, required
    - `limit` unknown, required
    - `complete` unknown, required

## Other responses

- `400`: Missing, malformed, or extra query parameter.
- `401`: Missing or invalid authentication.
- `403`: API key, OAuth, workspace, or capability denied.
- `429`: Upstream workspace read rate limited.
- `502`: Native CRM read unavailable or response invalid.
- `503`: Native read service unavailable.

---

[API](https://skmtc.dev/bamf/apis/bamf-developer-platform-api.md) · [All operations](https://skmtc.dev/bamf/apis/bamf-developer-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bamf/apis/bamf-developer-platform-api/revisions/a390dd3294bd?raw)