Skip to Content
API & MCPPOSTList people filter values

REST API

List people filter values

The values of a person field with how many people carry each.

POST/v1/people/values
MCP tool list_people_valuesscope companies:readNo record cost

Parameters

field"role" | "seniority" | "function" | "sub_function" | "territory" | "employment" | "tier" | "sources" | "person_country"required
limitintegeroptional
(min 1, max 500)

What your agent reads

The tool description exactly as an MCP client receives it in tools/list — it doubles as the full behaviour of the endpoint.

The values of a person field with how many people carry each — role, seniority, function, sub_function, territory, employment, person_country, tier, sources. Look values up instead of guessing.

Errors follow one format.