--- title: "⭐ Universal People Lookup Status API" method: GET path: "/universal/person/check_status" tags: ["People Data API"] --- # ⭐ Universal People Lookup Status API `GET /universal/person/check_status` Check Universal Person Lookup Status ## Query parameters - `ids` integer[] ## Response `200` Success. Returns the status and profile data of the requested profiles. - UniversalCreditPersonLookupOutput[] - `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 - `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 — This person's company's domain name. - `current_employer_website` string, nullable — This person's company's website. - `current_employer_linkedin_url` string, nullable — This person's company's LinkedIn URL. - `birth_year` string — 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 - `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) - `job_history` JobHistoryAPICompiledCompany[] — [`reveal_detailed_person_enrichment=true` required or this field will not be returned] 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[] — [`reveal_detailed_person_enrichment=true` required or this field will not be returned] 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 — [`reveal_detailed_person_enrichment=true` required or this field will not be returned] List of skills for the profile - `links` object — [`reveal_detailed_person_enrichment=true` required or this field will not be returned] Social media links for the profile - `npi_data` object — [`reveal_healthcare_enrichment=true` required or this field will not be returned] List of NPI data objects for the profile - `npi_number` string - `credentials` string - `license_number` string - `specialization` string - `recommended_email` string, nullable — [`reveal_personal_email OR reveal_professional_email=true` required or this field will not be returned] Recommended email for the profile - `emails` ProfileEmailAPI[] — [`reveal_personal_email OR reveal_professional_email=true` required or this field will not be returned] 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. - `recommended_personal_email` string, nullable — [`reveal_personal_email=true` required or this field will not be returned] Recommended personal email for the profile - `current_personal_email` string, nullable — [`reveal_personal_email=true` required or this field will not be returned] Current personal email for the profile - `recommended_professional_email` string, nullable — [`reveal_professional_email=true` required or this field will not be returned] Recommended professional email for the profile - `current_work_email` string, nullable — [`reveal_professional_email=true` required or this field will not be returned] Current work email for the profile - `phones` ProfilePhoneAPI[] — [`reveal_phone=true` required or this field will not be returned] 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)