1. Discovery search
Highperformr API
  • Introduction
  • Contacts
    • Unified Data API - async contact enrichment
      POST
    • Bulk fetch contacts by IDs
      POST
    • Get contacts by segment
      POST
    • Get contact by ID
      GET
    • Update contact
      PATCH
    • Delete contact
      DELETE
    • Upsert contact into a source
      POST
    • Bulk upsert contacts for source
      POST
    • Unique values of one field for a filtered contact set
      POST
  • Schema
    • Get contact schema
      GET
    • Get discovery search contact schema
      GET
    • Get discovery search company schema
      GET
    • Get verified discovery contact filter schema
      GET
    • Get verified discovery company filter schema
      GET
    • Get options for field
      GET
    • Verified discovery autocomplete suggestions
      GET
    • Get discovery search options for field
      GET
    • Verified discovery static option lists
      GET
  • Discovery search
    • Find contacts v2
      POST
    • Find companies v2
      POST
    • Find verified contacts
      POST
    • Find verified companies
      POST
  • Jobs
    • Get job status by id
      GET
  • Social publishing
    • Create draft post
      POST
    • List posts (drafts, scheduled, published)
      POST
    • Schedule or publish posts (bulk)
      POST
    • Schedule a LinkedIn comment on an external post
      POST
    • Configure cross-account auto-repost
      POST
    • Upload media file (multipart)
      POST
    • Assemble chunked uploads into one file
      POST
    • Import media from a public URL
      POST
  • Integrations (social)
    • List social integrations (filter)
  • Segments
    • Type-ahead search for segments
    • Create segment
    • Get segment by ID
    • Update segment
    • Delete segment
    • Clone segment
  • Sources
    • Bulk upsert sources
    • Bulk fetch sources
    • Bulk update sources
    • Create source
    • Pull contacts from source
    • Get source by ID
    • Update source
  • Credits
    • Get workspace credit balance
Login
  1. Discovery search

Find verified contacts

POST
/discovery-search/find-verified-contacts
Verified & enriched contact preview search. Filters are a flat inputFieldMapping array — each row is { sourceFieldName, userInput }. Do not send groupedCondition.
Schema: GET /schema/verified-discovery/contact — use name as sourceFieldName. JSON fields include childFields and exampleUserInput for structured userInput shapes.
Credits: With a workspace or user API key, 4 credits per contact returned in data. Use limit or numberOfContactsToPull in inputFieldMapping to cap the page (max 25). Session/in-app preview is not billed.
Company name/website lists: excludeCompanyName and excludeCompanyWebsite each support at most 500 values. Combined company names and websites (include and exclude, including additionalCompanyNames, additionalCompanyWebsites, companyName, and companyWebsite) cannot exceed 500. Oversized lists return 400 (not truncated).
Pagination: Each page returns at most 25 rows. Results are ranked; there is no sort or cursor, so later pages can shift. Max page is 1000.
Job title: Send jobTitle (string[]). Default match is CONTAINS (substring) — e.g. cto also matches Director and Doctor. Set jobTitleMatchMode to EXACT or SIMILAR for tighter matching. Optional jobTitleSmartIntensity (LOOSE | NORMAL | STRICT) applies only with SIMILAR. GET /schema/verified-discovery/search-suggestions/jobTitleSearch is type-ahead only; copy suggestion values into jobTitle.
Persistence: Find does not save rows into a segment. Review data, then create an importFromWebhook source (POST /sources) with sourceMeta.config.fieldMapping, and upsert chosen rows with POST /contacts/{sourceId}/bulk-upsert-contacts.
MCP / agents: Fetch schema first, then build inputFieldMapping from meta.jsonFieldExamples and scalar rows (jobTitle, managementLevel, etc.).

Request

Authorization
API Key
Add parameter in header
x-api-key
Example:
x-api-key: ********************
or
Body Params application/jsonRequired

Examples

Responses

🟢200
application/json
Preview rows and pagination meta.
Bodyapplication/json

🟠400
🟠401
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://app.highperformr.ai/api/discovery-search/find-verified-contacts' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "page": 1,
    "companyWebsite": "salesforce.com",
    "fields": [
        "fullName",
        "jobTitle",
        "linkedIn",
        "hasEmail"
    ],
    "inputFieldMapping": [
        {
            "sourceFieldName": "jobTitle",
            "userInput": [
                "CEO",
                "Chief Executive Officer"
            ]
        },
        {
            "sourceFieldName": "jobTitleMatchMode",
            "userInput": "CONTAINS"
        },
        {
            "sourceFieldName": "managementLevel",
            "userInput": [
                "C-Suite",
                "Vice President"
            ]
        },
        {
            "sourceFieldName": "companyFounded",
            "userInput": {
                "min": 2010,
                "max": 2024,
                "include_unknown_founded": true
            }
        },
        {
            "sourceFieldName": "companyHeadcountByDepartment",
            "userInput": [
                {
                    "department": "Sales",
                    "min": 10,
                    "max": 100
                }
            ]
        },
        {
            "sourceFieldName": "companyFunding",
            "userInput": {
                "stage": [
                    "Seed",
                    "Series A"
                ],
                "funding_date": 365
            }
        }
    ]
}'
Response Response Example
200 - Example 1
{
    "data": [
        {}
    ],
    "meta": {
        "totalRecords": 12840,
        "previousToken": "eyJvIjoxfQ",
        "nextToken": "eyJvIjoyfQ"
    }
}
Modified at 2026-09-10 06:41:09
Previous
Find companies v2
Next
Find verified companies
Built with