--- title: "Lookup multiple people by LinkedIn handle or Ocean ID" method: POST path: "/v2/lookup/people" tags: ["Lookup"] --- # Lookup multiple people by LinkedIn handle or Ocean ID `POST /v2/lookup/people` Lookup and enrich multiple people by LinkedIn handles and/or Ocean.io IDs (max 1000 total). This endpoint provides simple, per-result pricing. **Key features:** - Batch lookup up to 1000 people (combined total of linkedinHandles + oceanIds) - Provide either linkedinHandles, oceanIds, or both lists Returns only successfully matched people in the response. ## Query parameters - `apiToken` string, nullable ## Headers - `x-api-token` string, nullable ## Request body - LookupPeopleRequest - `linkedinHandles` string[] — List of LinkedIn profile handles to lookup (e.g., ['john-doe', 'jane-smith']) - `oceanIds` string[] — List of Ocean.io person IDs to lookup (e.g., ['abc123', 'def456']) ## Response `200` Successful Response - LookupPeopleResponse - `people` LookalikePerson[], required — List of enriched people found. Only includes successfully matched people. - `id` string, required — Internal ocean id of the person - `domain` string, required — Domain of the company the person is working for - `name` string, nullable — Full name of the person - `firstName` string, nullable — First name of the person - `lastName` string, nullable — Last name of the person - `country` string, nullable — Country code of the person - `state` string, nullable — State code of the person - `location` string, nullable — Location of the person - `linkedinUrl` string, nullable — Link to the linkedin profile of the person - `seniorities` Seniority[], nullable — List of seniorities computed from the job title of the person - `departments` Department[], nullable — List of departments computed from the job title of the person - `photo` string, nullable — Link to the person's profile picture on LinkedIn - `jobTitle` string, nullable — Job title of the person - `jobTitleEnglish` string, nullable — English translation of the person's job title - `currentJobDescription` string, nullable — Current job description of the person - `experiences` Experience[], nullable — List of experiences of the person - `domain` string, nullable — Domain of the company the person is working for - `jobTitle` string, nullable — Job title of the person - `dateFrom` string, nullable — Start date of the experience - `dateTo` string, nullable — End date of the experience - `description` string, nullable — Description of the experience - `linkedinCompanyHandle` string, nullable — Linkedin handle of the company the person is working for - `summary` string, nullable — Summary of the person - `skills` string[], nullable — Skills of the person - `phone` PublicApiModelsPersonPhone - `numbers` string[], nullable, required — Phone numbers - `status` 'verified' | 'notFound' | 'inProgress', required — Status of the phone numbers: verified or not found - `email` PublicApiModelsPersonEmail - `address` string, nullable, required — Email address - `status` 'verified' | 'guessed' | 'catchAll' | 'notFound', required — Status of the address: verified, catchAll or guessed - `inferredEmails` string[] — List of inferred email addresses for the person. This is only available for enterprise subscriptions. - `updatedAt` string, nullable — When has the person data been updated for the last time - `connectionsCount` integer, nullable — Number of LinkedIn connections of the person - `followersCount` integer, nullable — Number of LinkedIn followers of the person - `headline` string, nullable — Headline of the person - `company` PersonCompany - `companySize` '0-1' | '2-10' | '11-50' | '51-200' | '201-500' | '501-1000' | '1001-5000' | '5001-10000' | '10001-50000' | '50001-100000' | '100001-500000' | '500000+' - `logo` string, nullable — Logo of the company (URL) - `name` string, nullable — Name of the company - `revenue` '0-1M' | '1-10M' | '10-50M' | '50-100M' | '100-500M' | '500-1000M' | '>1000M' - `employeeCountOcean` integer, nullable — Number of people working at the company in our database. - `industries` string[], nullable — Industries of the company
Available values can be found at /v2/data-fields endpoint. - `technologies` string[], nullable — Software technologies used by the company - `fundingRound` FundingRound - `date` string, nullable — Date of the funding round - `type` 'Seed' | 'Series A' | 'Angel' | 'Series B' | 'Series Unknown' | 'Pre-Seed' | 'Grant' | 'Series C' | 'Convertible Note' | 'Debt Financing' | 'Non-Equity Assistance' | 'Undisclosed' | 'Series D' | 'Corporate Round' | 'Equity Crowdfunding' | 'Product Crowdfunding' | 'Series E' | 'Private Equity' | 'Secondary Market' | 'Initial Coin Offering' | 'Post-IPO Equity' | 'Series F' | 'Post-IPO Debt' | 'Series H' | 'Series G' | 'Post-IPO Secondary' | 'Series I' | 'Series J' - `moneyRaisedInUsd` integer, nullable — Amount of money raised in USD - `cbUrl` string, nullable — URL of the funding round on Crunchbase - `relevance` 'A' | 'B' | 'C', nullable — Relevance category (A - the most relevant) - `totalRequested` integer, required — Total number of identifiers requested - `totalFound` integer, required — Total number of people found - `creditsUsed` number, required — Number of credits charged for this request. ## Other responses - `400` — Bad Request - `402` — Payment Required - `403` — Forbidden - `404` — Not found - `422` — Validation Error ## Changes - **2026-08-24** `7be4c13a1cf6` — 5 warning - added the new `Education` enum value to the `people/items/departments/items/` response property for the response status `200` - added the new `Entry` enum value to the `people/items/seniorities/items/` response property for the response status `200` - added the new `Intern` enum value to the `people/items/seniorities/items/` response property for the response status `200` - added the new `Professional` enum value to the `people/items/seniorities/items/` response property for the response status `200` - …1 more [Change history](https://skmtc.dev/ocean/apis/ocean-io-api-documentation/changes/v2/lookup/people/post.md) --- [API](https://skmtc.dev/ocean/apis/ocean-io-api-documentation.md) · [All operations](https://skmtc.dev/ocean/apis/ocean-io-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ocean/ocean-io-api-documentation/revisions/505121e48722/schema)