---
title: "List active leads available to this key."
method: GET
path: "/customer/leads"
tags: ["Customer REST"]
---

# List active leads available to this key.

`GET /customer/leads`

## Query parameters

- `limit` integer
- `cursor` string
- `tier` 'UNQUALIFIED' | 'NURTURE' | 'QUALIFIED' | 'PRIORITY'
- `leadTiers` string
- `disposition` 'ACTIVE' | 'CLIENT' | 'BAD_LEAD'
- `dispositions` string
- `minIcpMatchPercent` integer
- `maxIcpMatchPercent` integer
- `monitoredProfileId` string, uuid
- `monitoredProfileIds` string
- `postId` string, uuid
- `engagementType` 'LIKE' | 'COMMENT' | 'REPOST'
- `engagementTypes` string
- `ownerId` string, uuid
- `ownerIds` string
- `dateFrom` string, date-time
- `dateTo` string, date-time
- `query` string
- `companyNames` string
- `origin` 'agent' | 'watchlist' | 'all'

## Response `200`

Lead page. Contact fields are null unless the key has leads:contact_read.

- LeadPage
  - `data` object[], required
    - `id` string, uuid, required
    - `icpMatchPercent` integer, nullable
    - `intentScore` number
    - `leadTier` string, nullable
    - `profile` object, required
    - `contact` object, nullable, required — Null unless the key has leads:contact_read.
  - `page` object, required
    - `limit` integer, required
    - `cursor` string, nullable
    - `nextCursor` string, nullable, required

## Other responses

- `400` — Request failed boundary validation.
- `401` — Invalid, expired, or revoked API key.
- `402` — Key or OAuth grant lacks the required scope.
- `429` — Customer API rate limit exceeded. Retry after the delay in the Retry-After header.

---

[API](https://skmtc.net/windmill-growth/apis/traxy-customer-api-and-mcp-v1.md) · [All operations](https://skmtc.net/windmill-growth/apis/traxy-customer-api-and-mcp-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/windmill-growth/traxy-customer-api-and-mcp-v1/revisions/5ea23c14f8cf/schema)