---
title: "Query client People"
method: POST
path: "/crm/people/query"
---

# Query client People

`POST /crm/people/query`

## Request

- Base URL: `https://api.bamf.ai/v1`
- URL: `https://api.bamf.ai/v1/crm/people/query`
- Auth: HTTP bearer

Requires a BAMF user JWT; BAMF API keys are rejected. agent_sessions:read public admission and downstream client.crm.read workspace capability are required. Client ownership is resolved by the server. Read-only: no provider calls or sends. People filters: limit 1–200, days 1–120, channels_min 1–7, min_icp 0–100, text up to 160 characters; candidate scan capped at 1,000 and result may be truncated.

## Request body

- object
  - `workspace_id` string, uuid, required
  - `params` object
    - `temperature` string[]
    - `min_icp` number: Values through 1 are a fraction; larger values are a percentage.
    - `channels_min` integer
    - `days` integer
    - `signal_classes` string[]
    - `lanes` string[]
    - `stages` string[], nullable
    - `tags` string[], nullable
    - `needs_reply` boolean
    - `text` string, nullable
    - `limit` integer
    - `sort` 'score' | 'recent' | 'icp'

## Response `200`

data contains normalized CRM version/action/workspace/result; outer workspace_id/read_only:true/provider_mutation:false. No idempotency key needed.

## Other responses

- `400`: Invalid workspace/filter or extra field
- `401`: Missing/invalid authentication
- `403`: API key or workspace/capability denied
- `502`: Native CRM read unavailable or invalid response

---

[API](https://skmtc.dev/bamf/apis/bamf-developer-platform-api.md) · [All operations](https://skmtc.dev/bamf/apis/bamf-developer-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bamf/apis/bamf-developer-platform-api/revisions/a390dd3294bd?raw)