---
search:
  tags:
    - Leads
    - GET
seo:
  description: >-
    Leads in the key holder's Leads Sent scope. The account sees agreements it
    holds. A parent… Reference for the GET /api/leads endpoint in the
    Comarketing API.
sidebar:
  label: List leads you sent
  badge: GET
title: List leads you sent
type: openapi-operation
---
Leads in the key holder's Leads Sent scope. The account sees agreements it holds. A parent account sees the accounts under it. Leads only received as the partner are not included. Queued rows stay in the list.

`page` defaults to 1. A missing or invalid `page` uses 1. `pageSize` defaults to 25 and is clamped to 50. A missing or invalid `pageSize` uses 25.

Each item has the contact fields Leads Sent shows. Stored status `completed` is returned as `won`. `delivery` is `queued` when the lead is not shared, otherwise `delivered`. A queued item includes `queuedReason`.

`GET /api/leads`

**Responses**

- `200` — A page of leads this account sent.
- `401` — The key is missing or unknown.
- `403` — The key cannot send leads.

Response example, 200:

```json
{
  "items": [],
  "total": 0,
  "page": 1,
  "pageSize": 25,
  "hasMore": false
}
```

Response example, 401:

```json
{
  "error": "Invalid API key."
}
```

Response example, 403:

```json
{
  "error": "This key cannot send leads."
}
```