--- title: "Look up people" method: POST path: "/people/lookup" --- # Look up people `POST /people/lookup` Look up a single person using their identifiers (professional network URL/ID, or full name combined with a company identifier). Returns the best matching person. ## Request body - LookUpPeopleRequest — Provide at least one identifier to match a single person. The professional network URL or ID is the most reliable. A full name can be combined with a company identifier (domain, professional network URL, or professional network ID) to disambiguate the match. - `person_name` string — Full name of the person to look up. - `person_professional_network_url` string — Professional network profile URL of the person. - `person_professional_network_id` integer — Professional network profile ID of the person. - `company_professional_network_url` string — Professional network URL of the company the person works for. Used to disambiguate when looking up by name. - `company_professional_network_id` integer — Professional network ID of the company the person works for. Used to disambiguate when looking up by name. - `company_domain` string — Domain of the company the person works for. Used to disambiguate when looking up by name. ## Response `200` OK - object - `people` Person[] — Array containing the matching person. Returns an empty array if no match is found. - `id` string — Unique person identifier - `full_name` string — Person's full name - `first_name` string — Person's first name - `last_name` string — Person's last name - `location` object — Person's location information - `country` string — Country name - `country_code` string — ISO country code - `city` string — City name - `region` string — Region or state - `social_profiles` PersonSocialProfile - `professional_network` object — Professional network profile information - `id` integer — Professional network profile ID - `url` string — Full professional network profile URL - `handle` string — Professional network profile handle/username - `connection_count` integer — Number of professional network connections - `educations` PersonEducation[] — Person's education history - `school_name` string — Name of the educational institution - `degree` string — Degree or qualification obtained - `start_at` string, date-time — Start date in ISO 8601 format with T separator (YYYY-MM-DDTHH:MM:SSZ) - `end_at` string, date-time — End date in ISO 8601 format with T separator (YYYY-MM-DDTHH:MM:SSZ) - `languages` PersonLanguage[] — Languages spoken by the person - `language` string — Language name - `proficiency` string — Proficiency level in the language (e.g., 'NATIVE_OR_BILINGUAL', 'FULL_PROFESSIONAL', 'PROFESSIONAL_WORKING', 'LIMITED_WORKING', 'ELEMENTARY') - `skills` string[] — Person's professional skills - `employment` object — Person's employment history - `current` Employment - `title` string — Job title or position - `seniority` string — Seniority level of the person in the company - `job_functions` object[] — Job functions of the person in the company - `function` string — Job function - `sub_function` string — Sub function of the job function - `description` string — Description of the role and responsibilities. Not always present. - `company` EmploymentCompany - `id` string — Unique company identifier - `name` string — Company name - `domain` string — Company domain - `description` string — Company description - `year_founded` integer — Year the company was founded. Returns 0 when unknown. - `headcount` integer — Exact number of employees. May return 0 even when headcount_range is available. - `headcount_range` string — Employee count range (e.g., '1-10', '11-50', '51-200', '201-500', '501-1000', '1001-5000', '5001-10000', '10001+') - `company_type` string — Type of company (e.g., 'Public Company', 'Privately Held', 'Nonprofit', 'Self-Employed', 'Partnership', 'Educational', 'Government Agency') - `specialties` string[] — Specialties associated with the company - `locations` object — Company location information - `headquarters` CompanyAddress — Structured headquarters address with parsed location fields - … - `offices` OfficeAddress[], nullable — Additional office locations. Only contains raw address lines (line1, line2) without structured city/region/country fields. Can be null or an empty array. - … - `industry` object — Company industry information - `main_industry` string — Primary industry category (e.g., 'Software Development', 'Computer Hardware Manufacturing', 'Financial Services', 'Healthcare') - `social_profiles` CompanySocialProfile - `professional_network` object — Professional network profile information - … - `is_current` boolean — Whether this is the current employment - `start_at` string, date-time — Employment start date in ISO 8601 format with T separator (YYYY-MM-DDTHH:MM:SSZ) - `end_at` string, date-time — Employment end date in ISO 8601 format with T separator (YYYY-MM-DDTHH:MM:SSZ). This field is not returned for current employment (when is_current is true). - `all` Employment[] — All employment history (current and past) - `title` string — Job title or position - `seniority` string — Seniority level of the person in the company - `job_functions` object[] — Job functions of the person in the company - `function` string — Job function - `sub_function` string — Sub function of the job function - `description` string — Description of the role and responsibilities. Not always present. - `company` EmploymentCompany - `id` string — Unique company identifier - `name` string — Company name - `domain` string — Company domain - `description` string — Company description - `year_founded` integer — Year the company was founded. Returns 0 when unknown. - `headcount` integer — Exact number of employees. May return 0 even when headcount_range is available. - `headcount_range` string — Employee count range (e.g., '1-10', '11-50', '51-200', '201-500', '501-1000', '1001-5000', '5001-10000', '10001+') - `company_type` string — Type of company (e.g., 'Public Company', 'Privately Held', 'Nonprofit', 'Self-Employed', 'Partnership', 'Educational', 'Government Agency') - `specialties` string[] — Specialties associated with the company - `locations` object — Company location information - `headquarters` CompanyAddress — Structured headquarters address with parsed location fields - … - `offices` OfficeAddress[], nullable — Additional office locations. Only contains raw address lines (line1, line2) without structured city/region/country fields. Can be null or an empty array. - … - `industry` object — Company industry information - `main_industry` string — Primary industry category (e.g., 'Software Development', 'Computer Hardware Manufacturing', 'Financial Services', 'Healthcare') - `social_profiles` CompanySocialProfile - `professional_network` object — Professional network profile information - … - `is_current` boolean — Whether this is the current employment - `start_at` string, date-time — Employment start date in ISO 8601 format with T separator (YYYY-MM-DDTHH:MM:SSZ) - `end_at` string, date-time — Employment end date in ISO 8601 format with T separator (YYYY-MM-DDTHH:MM:SSZ). This field is not returned for current employment (when is_current is true). - `metadata` object - `credits` number, double — Total number of credits consumed ## Other responses - `400` — Bad Request - `401` — Unauthorized - `429` — Too Many Requests --- [API](https://skmtc.dev/fullenrich/apis/fullenrich-api-documentation.md) · [All operations](https://skmtc.dev/fullenrich/apis/fullenrich-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fullenrich/fullenrich-api-documentation/revisions/b6357fb61fc7/schema)