People Lookup API

get

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

Person Enrichment API

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

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

lookup_type

string | null

enum

Lookup type for the request

standard - standard
premium - premium
premium (feeds disabled) - premium (feeds disabled)
bulk - bulk
phone - phone
enrich - enrich

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.

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.