Sign in

v1

latestOpenAPI 3.1.02026-07-241640107.8 KB
People Data API
Company Data API

People and Company Lookup API

Person and Company Lookup

get/profile-company/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
lookup_type'standard' | 'premium' | 'premium (feeds disabled)' | 'bulk' | 'phone' | 'enrich' | '' | 'null' nullable

Lookup type for the request

  • standard - standard
  • premium - premium
  • premium (feeds disabled) - premium (feeds disabled)
  • bulk - bulk
  • phone - phone
  • enrich - enrich
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>

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 and company data for the person / company 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

linksobject

Social media links for the 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.

current_employer_industrystring nullable

This person's company's industry.

skillsstring[] nullable

List of skills for the profile

birth_yearinteger

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

tagsstring
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)
recommended_emailstring nullable

Recommended email for the profile

recommended_personal_emailstring nullable

Recommended personal email for the profile

recommended_professional_emailstring nullable

Recommended professional email for the profile

current_work_emailstring nullable

Current work email for the profile

current_personal_emailstring nullable

Current personal email for the profile

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
    }
  ],
  "company": {
    "id": 123456
  }
}