---
title: "List watchlist profiles."
method: GET
path: "/customer/watchlist/profiles"
tags: ["Customer REST"]
---

# List watchlist profiles.

`GET /customer/watchlist/profiles`

## Request

- Base URL: `https://api.traxy.ai/api/v1`
- URL: `https://api.traxy.ai/api/v1/customer/watchlist/profiles`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/windmill-growth/apis/traxy-customer-api-and-mcp-v1/docs/customer/watchlist/profiles/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `limit` integer
- `cursor` string
- `entityType` 'PERSON' | 'COMPANY'
- `profileType` 'TEAMMATE' | 'COMPETITOR' | 'INFLUENCER' | 'INVESTOR' | 'CUSTOM' | 'TARGET_ACCOUNT' | 'CUSTOMER' | 'PARTNER'
- `profileTypes` string
- `source` 'MEMBER_ONBOARDING' | 'MANUAL_WATCHLIST'
- `slotKind` 'SELF' | 'STANDARD' | 'COMPETITOR'
- `relationshipLabel` string
- `state` 'ACTIVE' | 'PAUSED'
- `query` string
- `sort` 'createdAt' | 'followers' | 'lastEngagementSyncAt' | 'displayName' | 'qualifiedLeads'
- `sortDirection` 'asc' | 'desc'

## Response `200`

Paginated watchlist profiles with how many match the filters across all pages.

- object
  - `data` object[], required
  - `page` object, required
    - `limit` integer, required
    - `cursor` string, nullable
    - `nextCursor` string, nullable, required
  - `total` integer, required: Profiles matching the filters across all pages.
  - `totalByEntityType` object, required
    - `PERSON` integer, required
    - `COMPANY` integer, required

## Other responses

- `400`: Request failed boundary validation.
- `401`: Invalid, expired, or revoked API key.
- `402`: Key or OAuth grant lacks the required scope.

## Changes

- **2026-11-11** `765b1a6a3abd`: 3 breaking, 3 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 the new optional `query` request parameter `entityType`
  - …2 more
- **2026-10-26** `5dad61cc8aea`: 3 info
  - added the new enum value `CUSTOMER` to the `query` request parameter `profileType`
  - added the new enum value `PARTNER` to the `query` request parameter `profileType`
  - added the new enum value `TARGET_ACCOUNT` to the `query` request parameter `profileType`
- **2026-07-31** `5ea23c14f8cf`: 1 info
  - added the new enum value `INFLUENCER` to the `query` request parameter `profileType`
- **2026-07-13** `e60dfaf3c445`: 1 breaking, 1 warning, 10 info
  - 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 `profileType`
  - added the new optional `query` request parameter `profileTypes`
  - …8 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/windmill-growth/apis/traxy-customer-api-and-mcp-v1/changes/customer/watchlist/profiles/get.md)

---

[API](https://skmtc.dev/windmill-growth/apis/traxy-customer-api-and-mcp-v1.md) - [All operations](https://skmtc.dev/windmill-growth/apis/traxy-customer-api-and-mcp-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/windmill-growth/apis/traxy-customer-api-and-mcp-v1/revisions/765b1a6a3abd?raw)