⭐ Universal People Lookup API

get

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

Person Enrichment API

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

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

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.