---
title: "Your lead lists, newest first"
method: GET
path: "/lists"
tags: ["Leads"]
---

# Your lead lists, newest first

`GET /lists`

## Request

- Base URL: `https://mcp.senders.ai/api/v1`
- URL: `https://mcp.senders.ai/api/v1/lists`
- Auth: HTTP bearer

Scope: leads:read

## Response `200`

OK

- object
  - `data` List[], required
    - `id` integer, required
    - `name` string, required
    - `source` string, nullable
    - `notes` string, nullable
    - `lead_count` integer, required
    - `created_at` string, date-time, nullable: ISO 8601, UTC

## Other responses

- `401`: Missing, wrong or revoked token (unauthorized)
- `403`: Missing scope (forbidden), paused account (account_inactive) or plan without the API (feature_not_enabled)
- `429`: Rate limited (rate_limited, daily_limit). Wait Retry-After seconds.

---

[API](https://skmtc.dev/senders/apis/senders-rest-api.md) · [All operations](https://skmtc.dev/senders/apis/senders-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/senders/apis/senders-rest-api/revisions/3cd9960bc0af?raw)