---
title: "⭐ Universal Bulk People Lookup API"
method: POST
path: "/universal/person/bulk_lookup"
tags: ["People Data API"]
---

# ⭐ Universal Bulk People Lookup API

`POST /universal/person/bulk_lookup`

Bulk People Lookup by Criteria

## Request body

- UniversalCreditAPIBulkLookupQuery
  - `queries` UniversalCreditPersonLookupInput[] — Specify the lookup criteria for up to 100 people.
    - `id` integer — RocketReach internal unique profile ID
    - `name` string — Name of the desired profile. Must specify along with `current_employer`
    - `current_employer` string — Current employer of the desired profile. Must specify along with `name`
    - `title` string — Job title of the desired profile
    - `linkedin_ext_url` string — linkedin_ext_url deprecated, please use `linkedin_url`
    - `linkedin_url` string — LinkedIn URL of the desired profile
    - `email` string, email — An email address for the desired profile
    - `phone` string — A phone number for the desired profile in either E.164 format or international format. - Example: `+15555555555`
    - `npi_number` integer — An NPI number for the desired profile (US healthcare professional)
    - `reveal_phone` boolean — Whether to reveal the phone enrichment data for the desired profile
    - `reveal_professional_email` boolean — Whether to reveal the professional email enrichment data for the desired profile
    - `reveal_personal_email` boolean — Whether to reveal the personal email enrichment data for the desired profile
    - `reveal_detailed_person_enrichment` boolean — Whether to reveal the detailed person enrichment data for the desired profile
    - `reveal_healthcare_enrichment` boolean — Whether to reveal the healthcare enrichment data for the desired profile
    - `metadata` object, nullable — User metadata about the profile, such as external ids, tags, notes, etc.
  - `profile_list` string — Add specified contacts to this profile list.
  - `webhook_id` integer — ID of the webhook to post lookup results upon completion.

## Response `200`

Success. Bulk lookup request accepted

## Other responses

- `400` — Bad Request. The request is malformed or missing required parameters.
- `401` — Unauthorized. API Key is missing or invalid.
- `403` — Forbidden. API Key lacks permission to perform this action.
- `404` — Not Found. The requested resource (e.g., profile) does not exist.
- `429` — Too Many Requests. API request limit reached -- slow down requests.
- `500` — Internal Server Error. Unexpected error on RocketReach servers. Try again later.

---

[API](https://skmtc.dev/rocketreach/apis/rocketreach-api.md) · [All operations](https://skmtc.dev/rocketreach/apis/rocketreach-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rocketreach/rocketreach-api/revisions/68b5a27dfb6d/schema)