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 takes email, phone, or first_name + last_name + domain/company, the same as the single-lookup body. Capped by your subscription's bulk size limit. A request where no entry has any of these is refused with 400.

Example:

Only changes rows that have an email or phone. When true, a row whose email or phone finds nobody is then searched by name (first_name, last_name, and domain or company). A row with only a name and a company is always searched by name and does not need this.

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