Bulk fetch contacts by IDs

POST

/contacts/bulk-fetch

Load up to 100 contacts by their contact id (the same id returned in contact records and list APIs). Send at least one ID in contactIds. The API returns 400 if you send more than 100 IDs.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

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

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

List of contacts

Bodyapplication/json

🟠400

🟠401

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://app.highperformr.ai/api/contacts/bulk-fetch' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "contactIds": [
        "example"
    ]
}'

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"
        }
    ]
}

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

Introduction

Get contacts by segment