v1

latestOpenAPI 3.1.02026-07-241640107.8 KB

People Data API

⭐ Universal People Lookup API

Person Enrichment API

get/universal/person/lookup

Query parameters

current_employerstring

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

Example: RocketReach

emailstring email

An email address for the desired profile.

Example: jamie@rocketreach.co

idinteger

RocketReach internal unique profile ID.

Example: 123456

linkedin_ext_urlstring

linkedin_ext_url deprecated, please use linkedin_url instead

linkedin_urlstring

LinkedIn URL of the desired profile.

Example: www.linkedin.com/in/jamesgullbrand

metadataobject nullable

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

namestring

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

Example: Jamie Gullbrand

npi_numberinteger

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

Example: 1234567890

phonestring

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

Example: +15555555555

return_cached_emailsboolean

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.

<b>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.</b>

reveal_detailed_person_enrichmentboolean

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

reveal_healthcare_enrichmentboolean

Whether to reveal the healthcare enrichment data for the desired profile

reveal_personal_emailboolean

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

reveal_phoneboolean

Whether to reveal the phone enrichment data for the desired profile

reveal_professional_emailboolean

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

titlestring

Job title of the desired profile.

Example: Product Manager

webhook_idinteger

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

Response

Success. Returns the profile data for the person lookup.

idinteger

RocketReach internal unique profile ID

statusstring

Status of the profile lookup. Either "complete", "progress", "searching" or "not queued"

namestring nullable

Name of the profile

profile_picstring nullable

URL containing this profile's picture (if available).

linkedin_urlstring nullable

LinkedIn URL of the profile

connectionsinteger

Number of LinkedIn connections for this profile

locationstring nullable

Location of the profile

current_titlestring nullable

Current job title of the profile

current_employerstring nullable

Current employer of the profile

current_employer_idinteger

RocketReach internal unique company ID

current_employer_domainstring nullable

This person's company's domain name.

current_employer_websitestring nullable

This person's company's website.

current_employer_linkedin_urlstring nullable

This person's company's LinkedIn URL.

birth_yearstring

Year of birth of the profile

region_latitudenumber double nullable

Latitude of the region of the profile

region_longitudenumber double nullable

Longitude of the region of the profile

citystring nullable

City of the profile

regionstring nullable

Region of the profile

countrystring

Country of the profile

country_codestring nullable

Country code of the profile

return_cached_emailsboolean

Indicates if cached emails were returned in the initial synchronous response. If false, email fields will be null until the lookup is complete.

linkedin_url_activeboolean

Indicates if the LinkedIn profile exists or is no longer available.

True = Active (as of last update)
False = Unavailable (as of last update)

skillsstring[] nullable

[reveal_detailed_person_enrichment=true required or this field will not be returned] List of skills for the profile

linksobject

[reveal_detailed_person_enrichment=true required or this field will not be returned] Social media links for the profile

recommended_emailstring nullable

[reveal_personal_email OR reveal_professional_email=true required or this field will not be returned] Recommended email for the profile

recommended_personal_emailstring nullable

[reveal_personal_email=true required or this field will not be returned] Recommended personal email for the profile

current_personal_emailstring nullable

[reveal_personal_email=true required or this field will not be returned] Current personal email for the profile

recommended_professional_emailstring nullable

[reveal_professional_email=true required or this field will not be returned] Recommended professional email for the profile

current_work_emailstring nullable

[reveal_professional_email=true required or this field will not be returned] Current work email for the profile

metadataobject

User metadata associated with the profile lookup

Example response

{
  "profile_list": {
    "id": 123456,
    "name": "Example List Name"
  },
  "status": "progress",
  "emails": [
    {
      "email": "info@rocketreach.co",
      "smtp_valid": "valid",
      "type": "professional",
      "last_validation_check": "2026-01-01T12:00:00Z",
      "grade": "A-"
    }
  ],
  "phones": [
    {
      "number": "+1 234-555-6789",
      "e164": "+12345556789",
      "country_code": "1",
      "extension": "123",
      "type": "mobile",
      "validity": "valid",
      "recommended": true,
      "premium": true
    }
  ]
}