Sign in

v1

latestOpenAPI 3.1.02026-07-241640107.8 KB
People Data API

People Lookup Status API

Check Person Lookup Status

get/person/checkStatus

Query parameters

idsinteger[]

List of Profile IDs

Response

Success. Returns the status and profile data of the requested profiles.

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

Domain for the employer of the profile

current_employer_websitestring nullable

Website for the employer of the profile

current_employer_linkedin_urlstring nullable

LinkedIn URL for the employer of the profile

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
      }
    ]
  }
]