Find contacts v2

POST

/discovery-search/find-contacts-v2

Prospecting search for people matching groupedCondition and/or root conditions, plus fields and optional limit / paginationToken.

Field paths must match GET /schema/discovery-search-v2/contact (hpContact.* / hpCompany.*).
Filter operators follow the same rules as the shared Condition schema (by field type: string, numeric, date, multi-value, etc.).

Credits

With a workspace or user API key, 1 credit per contact returned in data. Use limit to cap usage.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

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

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Matching contacts and pagination meta (totalRecords, nextToken, etc.).

Bodyapplication/json

🟠401

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://app.highperformr.ai/api/discovery-search/find-contacts-v2' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "groupedCondition": {
        "operator": "AND",
        "conditions": [
            {
                "field": "hpContact.member_job_title",
                "operator": "LIKE",
                "value": "Engineer"
            },
            {
                "field": "hpCompany.industry",
                "operator": "IN",
                "value": [
                    "Computer Software",
                    "Internet"
                ]
            }
        ]
    },
    "fields": [
        "hpContact.member_full_name",
        "hpContact.member_job_title",
        "hpCompany.company_name",
        "hpCompany.industry"
    ],
    "limit": 42
}'

Response Example

200 - Success

{
    "data": [
        {
            "id": "cnt_7f3k9m2pqx",
            "firstName": "Jamie",
            "lastName": "Rivera",
            "fullName": "Jamie Rivera",
            "title": "Staff Software Engineer",
            "linkedIn": "https://www.linkedin.com/in/jamie-rivera-example",
            "emails": [
                "jamie.rivera@acme.io"
            ],
            "sources": [
                "src_csv_import_2025_01"
            ],
            "companies": [
                "cmp_4n8k2j1w"
            ],
            "primaryCompanyId": "cmp_4n8k2j1w",
            "company": {
                "id": "cmp_4n8k2j1w",
                "companyName": "Acme Analytics Inc",
                "companyWebsite": "https://www.acme.io",
                "companyIndustry": "Computer Software",
                "companyHeadcount": "201-500"
            },
            "createdAt": "2025-03-12T14:22:11.000Z",
            "updatedAt": "2025-04-08T09:01:44.000Z"
        }
    ],
    "meta": {
        "totalRecords": 12840,
        "previousToken": "eyJvIjoxfQ",
        "nextToken": "eyJvIjoyfQ"
    }
}

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

Get discovery search options for field

Find companies v2

Find contacts v2

Credits#

Request

Responses

Credits