Find verified companies

POST

/discovery-search/find-verified-companies

Verified & enriched company preview search. Same inputFieldMapping contract as POST /find-verified-contacts. Schema: GET /schema/verified-discovery/company.

Credits: With a workspace or user API key, 4 credits per company returned in data. Use limit or numberOfCompaniesToPull in inputFieldMapping to cap the page (max 25). Session/in-app preview is not billed.

Company name/website lists: Same 500-per-list and 500-combined caps as POST /find-verified-contacts. Oversized lists return 400.

Pagination: Each page returns at most 25 rows. Results are ranked; there is no sort or cursor. Max page is 1000.

Persistence: Find does not save companies into a segment. Create an importFromWebhook source with sourceMeta.config.fieldMapping, then upsert chosen rows via POST /contacts/{sourceId}/bulk-upsert-contacts.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

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

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Preview companies and meta.

Bodyapplication/json

🟠400

🟠401

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://app.highperformr.ai/api/discovery-search/find-verified-companies' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "page": 1,
    "limit": 6,
    "fields": [
        "companyName",
        "companyWebsite",
        "companyIndustry"
    ],
    "inputFieldMapping": [
        {
            "sourceFieldName": "numberOfCompaniesToPull",
            "userInput": 6
        },
        {
            "sourceFieldName": "companyIndustryInclude",
            "userInput": [
                "Software Development",
                "IT Services and IT Consulting"
            ]
        },
        {
            "sourceFieldName": "companyHeadcountRange",
            "userInput": [
                "51-100",
                "101-200"
            ]
        },
        {
            "sourceFieldName": "companyRevenue",
            "userInput": {
                "min": "10M",
                "max": "500M",
                "include_unknown_revenue": false
            }
        }
    ]
}'

Response Example

200 - Example 1

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

Modified at 2026-09-10 06:41:09

Find verified contacts

Get job status by id