---
title: "Bulk People Lookup API"
method: POST
path: "/bulkLookup"
tags: ["People Data API"]
---

# Bulk People Lookup API

`POST /bulkLookup`

Bulk People Lookup by Criteria

## Request body

- APIBulkLookupQuery
  - `queries` ProfileMatch[] — List of profile lookup queries for between 10 and 100 profiles
    - `id` integer — RocketReach internal unique profile ID. - Example: `123456`
    - `name` string — Name of the desired profile. Must specify along with `current_employer`. - Example: `Jamie Gullbrand`
    - `current_employer` string — Current employer of the desired profile. Must specify along with `name`. - Example: `RocketReach`
    - `title` string — Job title of the desired profile. - Example: `Product Manager`
    - `linkedin_ext_url` string — linkedin_ext_url deprecated, please use `linkedin_url`
    - `linkedin_url` string — LinkedIn URL of the desired profile. - Example: `www.linkedin.com/in/jamesgullbrand`
    - `email` string, email — An email address for the desired profile. - Example: `jamie@rocketreach.co`
    - `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) - Example: `1234567890`
    - `lookup_type` 'standard' | 'premium' | 'premium (feeds disabled)' | 'bulk' | 'phone' | 'enrich' — * `standard` - standard * `premium` - premium * `premium (feeds disabled)` - premium (feeds disabled) * `bulk` - bulk * `phone` - phone * `enrich` - enrich
    - `metadata` object, nullable — User metadata about the profile, such as external ids, tags, notes, etc.
  - `profile_list` string — Name of a profile list to add looked up profiles to upon completion
  - `webhook_id` integer — Webhook ID to post lookup results to upon completion. Find your webhook ID [here](https://rocketreach.co/account?section=nav_gen_api).

## 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)