Skip to main content
POST
Bulk-look up people by contact identifier

Authorizations

pubrio-api-key
string
header
required

A unique API token that represents the actions you perform through the API and the corresponding permissions and operations. You can create it through the Settings section.

Body

application/json
peoples
object[]
required

Array of lookup specs. Each entry accepts the same identifiers as the single-lookup body (email, phone, or first_name + last_name + domain/company when similarity search is enabled). Capped by your subscription's bulk size limit.

Example:

When true, falls back to a name-based similarity match if no exact email/phone hit is found. Requires first_name, last_name, and either domain or company.

Example:

true

Response

Successful response containing matched people and per-record match metadata.

data
object

Response info depends on specific endpoint.

Last modified on May 2, 2026