---
title: "Changes to List API-visible leads."
method: GET
path: "/customer/leads"
---

# Changes to List API-visible leads.

`GET /customer/leads`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 11 revisions.

- **2026-09-24** `3dde15782092`: 13 info
- **2026-07-13** `e60dfaf3c445`: 2 breaking, 1 warning, 20 info
- **2026-07-04** `467b330a307b`: 3 breaking, 1 info
- **2026-06-12** `f103a3a38e28`: 1 breaking, 3 info

## Changes

- **2026-09-24** `3dde15782092`: 13 info
  - added the new enum value `POST_AUTHOR` to the `query` request parameter `engagementType`
  - added the required property `allOf[subschema #2]/data/items/contact/contactPhone` to the response with the `200` status
  - added the required property `allOf[subschema #2]/data/items/contact/contactPhoneStatus` to the response with the `200` status
  - added the required property `allOf[subschema #2]/data/items/contact/personalEmail` to the response with the `200` status
  - added the required property `allOf[subschema #2]/data/items/contact/personalEmailStatus` to the response with the `200` status
  - added the required property `allOf[subschema #2]/data/items/contact/workEmail` to the response with the `200` status
  - added the required property `allOf[subschema #2]/data/items/contact/workEmailStatus` to the response with the `200` status
  - added the required property `allOf[subschema #2]/data/items/profile/currentCompany` to the response with the `200` status
  - added the required property `allOf[subschema #2]/data/items/profile/displayName` to the response with the `200` status
  - added the required property `allOf[subschema #2]/data/items/profile/headline` to the response with the `200` status
  - added the required property `allOf[subschema #2]/data/items/profile/location` to the response with the `200` status
  - added the required property `allOf[subschema #2]/data/items/profile/profileUrl` to the response with the `200` status
  - added the required property `allOf[subschema #2]/data/items/signal` to the response with the `200` status
- **2026-07-13** `e60dfaf3c445`: 2 breaking, 1 warning, 20 info
  - the `query` request parameter `tier` was restricted to a list of enum values
  - for the `query` request parameter `limit`, default value was changed from `25` to `50`
  - for the `query` request parameter `cursor`, the maxLength was set to `256`
  - added the new optional `query` request parameter `companyNames`
  - added the new optional `query` request parameter `dateFrom`
  - added the new optional `query` request parameter `dateTo`
  - added the new optional `query` request parameter `disposition`
  - added the new optional `query` request parameter `dispositions`
  - added the new optional `query` request parameter `engagementType`
  - added the new optional `query` request parameter `engagementTypes`
  - added the new optional `query` request parameter `leadTiers`
  - added the new optional `query` request parameter `maxIcpMatchPercent`
  - added the new optional `query` request parameter `monitoredProfileId`
  - added the new optional `query` request parameter `monitoredProfileIds`
  - added the new optional `query` request parameter `origin`
  - added the new optional `query` request parameter `ownerId`
  - added the new optional `query` request parameter `ownerIds`
  - added the new optional `query` request parameter `postId`
  - added the new optional `query` request parameter `query`
  - added the new enum value `NURTURE` to the `query` request parameter `tier`
  - added the new enum value `PRIORITY` to the `query` request parameter `tier`
  - added the new enum value `QUALIFIED` to the `query` request parameter `tier`
  - added the new enum value `UNQUALIFIED` to the `query` request parameter `tier`
- **2026-07-04** `467b330a307b`: 3 breaking, 1 info
  - the response's body type changed from `object` to no type for status `200`
  - removed the required property `data` from the response with the `200` status
  - removed the required property `page` from the response with the `200` status
  - added `#/components/schemas/PageEnvelope, subschema #2` to the response body `allOf` list for the response status `200`
- **2026-06-12** `f103a3a38e28`: 1 breaking, 3 info
  - the response's body type changed from no type to `object` for status `200`
  - removed `#/components/schemas/PageEnvelope, subschema #2` from the response body `allOf` list for the response status `200`
  - added the required property `data` to the response with the `200` status
  - added the required property `page` to the response with the `200` status

---

[Operation](https://skmtc.dev/windmill-growth/apis/traxy-customer-api-and-mcp-v1/docs/customer/leads/get.md) - [API](https://skmtc.dev/windmill-growth/apis/traxy-customer-api-and-mcp-v1.md) - [Page](https://skmtc.dev/windmill-growth/apis/traxy-customer-api-and-mcp-v1/changes/customer/leads/get)