Get Top Ranked Contacts

Returns top contacts ranked by contact_points_balance for the authenticated account, optionally filtered by tag UUIDs. Each result is identified by contact_uuid. The list is bounded by limit (default 25, max 100). Tag filtering accepts UUIDs only -- the legacy CI contract that filtered by tag NAMES (with_tags=name1,name2) is no longer supported on the new REST surface; unknown tag UUIDs return 422 with a canonical envelope. Both with_tag_uuids and without_tag_uuids accept either a comma-separated string OR a JSON array.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
integer
1 to 100
Defaults to 25

Quantity of contacts to return. Default 25, max 100.

string

Comma-separated tag UUIDs (or JSON array if posted in body). Contacts must have ALL tags listed. Each UUID must belong to the authenticated account.

string

Comma-separated tag UUIDs (or JSON array if posted in body). Contacts must have NONE of the tags listed. Each UUID must belong to the authenticated account.

Responses

401

Missing or invalid bearer token.

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json