---
title: "List customer leads"
method: GET
path: "/api/v2/host/customer-leads"
tags: ["host"]
---

# List customer leads

`GET /api/v2/host/customer-leads`

## Request

- Base URL: `https://api.momence.com`
- URL: `https://api.momence.com/api/v2/host/customer-leads`
- Auth: OAuth 2
  - Authorization code: `/api/v2/auth/authorize`
  - Password
  - Token URL: `/api/v2/auth/token`

Returns both open and converted leads. A lead with a non-null memberId has converted and can be joined to GET /api/v2/host/members/{memberId}.

## Query parameters

- `page` integer, required
- `pageSize` integer, required
- `sortOrder` 'ASC' | 'DESC'
- `sortBy` 'createdAt'
- `query` string
- `sourceId` integer
- `stageId` integer

## Response `200`

- object
  - `pagination` PaginatedResponseDataDto, required
    - `page` integer, required
    - `pageSize` integer, required
    - `totalCount` integer, required
    - `sortBy` string
    - `sortOrder` 'ASC' | 'DESC'
  - `payload` HostCustomerLeadDto[], required
    - `id` integer, required
    - `firstName` string, nullable, required
    - `lastName` string, nullable, required
    - `email` string, nullable, required
    - `phoneNumber` string, nullable, required
    - `sourceId` integer, required: Resolves against GET /api/v2/host/customer-lead-sources
    - `stageId` integer, nullable, required: Resolves against GET /api/v2/host/customer-lead-stages
    - `memberId` integer, nullable, required: Set once the lead converts into a customer. Same id as GET /api/v2/host/members/{memberId}, so a lead can be joined to its member.
    - `createdAt` string, date-time, required

## Changes

- **2026-11-03** `5adb9a85439b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/momence/apis/momence-public/changes/api/v2/host/customer-leads/get.md)

---

[API](https://skmtc.dev/momence/apis/momence-public.md) - [All operations](https://skmtc.dev/momence/apis/momence-public/llms.txt) - [OpenAPI document](https://skmtc.dev/momence/apis/momence-public/revisions/5adb9a85439b?raw)
