⭐ Universal People Lookup API

get

https://api.rocketreach.co/api/v2/universal/person/lookup

Person Enrichment API

🚫
Universal Credits are not currently available for Essentials, Pro, Ultimate plans. Please instead use: People Lookup API

ℹ️
Using this endpoint consumes export credits. You can check your current usage via the Account Endpoint.

🚨Universal Credits - Updates 🚨

The new Universal Credit system is now live. Account Managers will reach out with more details. You can find more information here: Universal Credits Overview

If you have any questions, please reach out to our team at [email protected].

Reminders:

You must specify at least 1 enrichment type below to get a response.
These query parameters are only available to customers that have access to the new universal credit system. If you try to use these without access, you'll receive a 403 Forbidden error.

Credit Action	Credit Cost	Enrichment Type Query Parameters
Professional Email	2 credits / person profile with verified (A or A-) emails	`reveal_professional_email`=`true`
Personal Email	3 credits / person profile with verified (A or A-) emails	`reveal_personal_email`=`true`
Phone	6 credits / person profile with phones	`reveal_phone`=`true`
Detailed Person Enrichment	1 credit / person profile with enriched information	`reveal_detailed_person_enrichment`=`true`
Healthcare Enrichment	1 credit / person profile with enriched information	`reveal_healthcare_enrichment`=`true`

Provide identifiers such as name, employer, or location to the RocketReach People Lookup API to quickly retrieve matching professional profiles.

Query Params

current_employer

string

length ≥ 1

Current employer of the desired profile. Must specify along with name.

Example: RocketReach

string

length ≥ 1

An email address for the desired profile.

Example: [email protected]

integer

RocketReach internal unique profile ID.

Example: 123456

linkedin_ext_url

string

length ≥ 1

deprecated

linkedin_ext_url deprecated, please use linkedin_url instead

linkedin_url

string

length ≥ 1

LinkedIn URL of the desired profile.

Example: www.linkedin.com/in/jamesgullbrand

metadata

object | null

User metadata about the profile, such as external ids, tags, notes, etc.

name

string

length ≥ 1

Name of the desired profile. Must specify along with current_employer.

Example: Jamie Gullbrand

npi_number

integer

An NPI number for the desired profile (US healthcare professional).

Example: 1234567890

phone

string

length ≥ 1

A phone number for the desired profile in either E.164 format or international format.

Example: +15555555555

return_cached_emails

boolean

Defaults to true

Controls whether cached emails are included in the initial response when lookup status = progress. When set to false, all email fields will be null until the lookup is complete and all emails are fully verified. Use /checkStatus or Webhooks to retrieve the completed response with fully verified emails (status = complete). Defaults to true.

NOTE: Default will change to false on September 1st, 2026. No cached emails will be returned in the initial response. Use /checkStatus or webhooks to retrieve fully verified emails.

reveal_detailed_person_enrichment

boolean

Defaults to false

Whether to reveal the detailed person enrichment data for the desired profile

reveal_healthcare_enrichment

boolean

Defaults to false

Whether to reveal the healthcare enrichment data for the desired profile

reveal_personal_email

boolean

Defaults to false

Whether to reveal the personal email enrichment data for the desired profile

reveal_phone

boolean

Defaults to false

Whether to reveal the phone enrichment data for the desired profile

reveal_professional_email

boolean

Defaults to false

Whether to reveal the professional email enrichment data for the desired profile

title

string

length ≥ 1

Job title of the desired profile.

Example: Product Manager

webhook_id

integer

Your webhook's unique ID number. Find it in your API Usage & Settings page.

Responses

🚨Universal Credits - Updates 🚨

200Success. Returns the profile data for the person lookup.

400Bad Request. The request is malformed or missing required parameters.

401Unauthorized. API Key is missing or invalid.

403Forbidden. API Key lacks permission to perform this action.

404Not Found. The requested resource (e.g., profile) does not exist.

429Too Many Requests. API request limit reached -- slow down requests.

500Internal Server Error. Unexpected error on RocketReach servers. Try again later.