--- title: "People Lookup API" method: GET path: "/person/lookup" tags: ["People Data API"] --- # People Lookup API `GET /person/lookup` Person Enrichment API ## Query parameters - `current_employer` string - `email` string, email - `id` integer - `linkedin_ext_url` string - `linkedin_url` string - `lookup_type` 'standard' | 'premium' | 'premium (feeds disabled)' | 'bulk' | 'phone' | 'enrich' | '' | 'null', nullable - `metadata` object, nullable - `name` string - `npi_number` integer - `phone` string - `return_cached_emails` boolean - `title` string - `webhook_id` integer ## Response `200` Success. Returns the profile data for the person lookup. - ProfileAPICompiledCompany - `profile_list` ProfileListAPI - `id` integer — RocketReach internal unique profile list ID - `name` string — Name of the profile list - `id` integer — RocketReach internal unique profile ID - `status` string — Status of the profile lookup. Either "complete", "progress", "searching" or "not queued" - `name` string, nullable — Name of the profile - `profile_pic` string, nullable — URL containing this profile's picture (if available) - `linkedin_url` string, nullable — LinkedIn URL of the profile - `connections` integer — Number of LinkedIn connections for this profile - `links` object — Social media links for the profile - `location` string, nullable — Location of the profile - `current_title` string, nullable — Current job title of the profile - `current_employer` string, nullable — Current employer of the profile - `current_employer_id` integer — RocketReach internal unique company ID - `current_employer_domain` string, nullable — Domain for the employer of the profile - `current_employer_website` string, nullable — Website for the employer of the profile - `current_employer_linkedin_url` string, nullable — LinkedIn URL for the employer of the profile - `current_employer_industry` string, nullable — This person's company's industry. - `job_history` JobHistoryAPICompiledCompany[] — List of professional experiences for the profile - `start_date` string, nullable — Start date of the work experience - `end_date` string — End date of the work experience (Present if experience is current) - `company` string, nullable — Name of the company - `company_name` string — Name of the company - `company_id` integer, nullable — RocketReach internal unique company ID - `company_linkedin_url` string — Linkedin URL of the company - `company_city` string — City of the company's location - `company_region` string — Region of the company's location - `company_country_code` string — Country code of the company's location - `department` string — Department of the work experience - `title` string — Job title of the work experience - `highest_level` string — Highest level of the work experience - `description` string — Description of the work experience - `last_updated` string, date-time — Timestamp of the last update of this work experience - `sub_department` string, nullable — Sub-department of the work experience - `is_current` boolean — True if the experience is the profile's current role, False otherwise - `education` EducationAPI[] — List of educational experiences for the profile - `major` string, nullable — Primary field of study of the educational experience - `school` string, nullable — School/University of the educational experience - `degree` string, nullable — Degree obtained through the educational experience - `start` integer, nullable — Start date of the educational experience - `end` integer, nullable — End date of the educational experience - `skills` string[], nullable — List of skills for the profile - `birth_year` integer — Year of birth of the profile - `region_latitude` number, double, nullable — Latitude of the region of the profile - `region_longitude` number, double, nullable — Longitude of the region of the profile - `city` string, nullable — City of the profile - `region` string, nullable — Region of the profile - `country` string — Country of the profile - `country_code` string, nullable — Country code of the profile - `npi_data` object — List of NPI data objects for the profile - `npi_number` string - `credentials` string - `license_number` string - `specialization` string - `tags` string - `return_cached_emails` boolean — 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_active` boolean — Indicates if the LinkedIn profile exists or is no longer available. * `True` = Active (as of last update) * `False` = Unavailable (as of last update) - `recommended_email` string, nullable — Recommended email for the profile - `recommended_personal_email` string, nullable — Recommended personal email for the profile - `recommended_professional_email` string, nullable — Recommended professional email for the profile - `current_work_email` string, nullable — Current work email for the profile - `current_personal_email` string, nullable — Current personal email for the profile - `emails` ProfileEmailAPI[] — List of email objects for the profile - `email` string — The email address. - Example: `info@rocketreach.co` - `smtp_valid` string, nullable — SMTP validation result. Options are `valid`, `invalid`, `accept-all`, or `unknown`. - Example: `valid` - `type` string, nullable — The type of email address. Options are `personal`, `professional`, `disposable`, or `role-based`. - Example: `professional` - `last_validation_check` string, nullable — Timestamp of the last validation check of the email address. - Example: `2026-01-01T12:00:00Z` - `grade` string — RocketReach internal grade for the email. See Email Grades for details. - `phones` ProfilePhoneAPI[] — List of phone number objects for the profile - `number` string — The phone number in international format - Example: `+1 234-555-6789` - `e164` string, nullable — The phone number in E.164 format - Example: `+12345556789` - `country_code` string, nullable — The country code associated with the phone number - Example: `1` for United States - `extension` string, nullable — The phone extension, if applicable - Example: `123` - `type` string — The type of phone number. Options are `mobile`, `landline`, `work`, `unknown`, `home`, or `fax`. - Example: `mobile` - `validity` string — Indicates whether a phone number matches a valid numbering pattern for the country/region. Options are valid or unknown. All invalid phones are removed - Example: `valid` - `recommended` boolean — Indicates whether this is the recommended phone number to use as the best option for connecting with the person. - Example: `true` - `premium` boolean — `premium` deprecated - `last_checked` string, date-time — `last_checked` deprecated ## Other responses - `400` — Bad Request. The request is malformed or missing required parameters. - `401` — Unauthorized. API Key is missing or invalid. - `403` — Forbidden. API Key lacks permission to perform this action. - `404` — Not Found. The requested resource (e.g., profile) does not exist. - `429` — Too Many Requests. API request limit reached -- slow down requests. - `500` — Internal Server Error. Unexpected error on RocketReach servers. Try again later. --- [API](https://skmtc.dev/rocketreach/apis/rocketreach-api.md) · [All operations](https://skmtc.dev/rocketreach/apis/rocketreach-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rocketreach/rocketreach-api/revisions/68b5a27dfb6d/schema)