Search filters
Every people filter the API, the app, the Claude connector and the CLI share: names, what each one does, the allowed values for dropdowns, which filters can leave people out, and which are ready right now. Free.
Include and exclude work together, also for the same kind of filter: an exclude filter leaves out everyone its include filter would find for the same values.
| Cost | What it does | Key scopes |
|---|---|---|
| Free | Reads only | argorant:read_counts |
Authorization
BearerAuth AuthorizationBearer <token>
Your API key from app.argorant.com/profile, sent as Authorization: Bearer <key>. A connector sign-in token (ag_mcp_...) works the same way.
In: header
Header Parameters
X-Request-Id?string
Your own id for this request, 8 to 64 letters, digits, dot, dash or underscore. Returned as X-Request-Id; one is made for you when you send none.
Match
^[A-Za-z0-9._-]{8,64}$Response Body
application/json
application/json
application/json
application/json
Shell
curl -X GET "https://app.argorant.com/api/v1/people/filters"JSON
{ "version": "2026-10-12.1", "filters": [ { "key": "title", "label": "Job titles", "kind": "text_list", "include": "title", "exclude": "exclude_title", "mode": "title_match", "ready": true }, { "key": "seniority", "label": "Seniority", "kind": "enum_list", "include": "seniority", "exclude": "exclude_seniority", "values": [ { "value": "C-Level", "label": "C-Level" }, { "value": "VP", "label": "VP" } ], "ready": true }, { "key": "gender", "label": "Gender", "kind": "enum_list", "include": "gender", "exclude": null, "ready": false, "reason": "Gender is still being added to every record." } ], "modes": { "title_match": { "default": "words", "values": [ { "value": "words", "label": "Whole words" }, { "value": "exact", "label": "Exact role" }, { "value": "contains", "label": "Contains the text" } ] }, "keyword_scope": { "default": "company", "values": [ { "value": "company", "label": "What the company does" }, { "value": "people", "label": "People's own skills and profiles" }, { "value": "any", "label": "Both" } ] } }, "ready_groups": [ "employees", "revenue" ], "bulk": { "lists": true, "exports": true, "selections": true }}