Unique values of one field for a filtered contact set

POST

/contacts/filter-unique-field-values-of-matching-contacts

Given optional contact conditions and a groupByField (a field path from GET /schema/contact), returns the distinct values that appear on matching contacts for that field.

Required: groupByField. Optional limit and paginationToken when there are many distinct values.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Success

Bodyapplication/json

🟠401

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://app.highperformr.ai/api/contacts/filter-unique-field-values-of-matching-contacts' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "conditions": [
        {
            "field": "contact.workEmail",
            "operator": "LIKE",
            "value": "@acme.com"
        }
    ],
    "groupByField": "example",
    "limit": 42,
    "paginationToken": "example"
}'

Response Example

200 - Success

{
    "data": [
        "example"
    ],
    "meta": {
        "totalRecords": 12840,
        "previousToken": "eyJvIjoxfQ",
        "nextToken": "eyJvIjoyfQ"
    }
}

Modified at 2026-04-22 07:54:17

Bulk upsert contacts for source

Unified Data API - async contact enrichment