---
title: "Lookalike people search"
method: POST
path: "/v3/search/people"
tags: ["Search"]
---

# Lookalike people search

`POST /v3/search/people`

Search people using filters and/or people Ids

Looking for the legacy endpoint? [Access it here](/docs/searchPeople)

**Webhook result:**
[Email results](/docs/webhooks/people_search_emails)
[Phone results](/docs/webhooks/people_search_phones)

## Query parameters

- `apiToken` string, nullable

## Headers

- `x-api-token` string, nullable

## Request body

- PublicSearchPeopleBodyV3
  - `size` integer — Number of people to return. The maximum value is 10,000.
  - `peopleFilters` PeopleFiltersV3
    - `lookalikeLinkedinHandles` string[], nullable — List of people linkedin handles to search for similar people.
    - `countries` string[], nullable — List of country codes (alpha-2 ISO 3166) to search for people.
    - `includePeopleIds` string[], nullable — List of people IDs to include in the search.
    - `includeLinkedinHandles` string[], nullable — List of people linkedin handles to include in the search.
    - `excludePeopleIds` string[], nullable — List of people IDs to exclude from the search.
    - `excludeLinkedinHandles` string[], nullable — List of people linkedin handles to exclude from the search.
    - `seniorities` Seniority[], nullable — Filter by seniorities. Available values are located at /v2/data-fields endpoint.
    - `skills` SkillsFilter
      - `allOf` string[], nullable — The LinkedIn profile skills must include all of these keywords
      - `anyOf` string[], nullable — The LinkedIn profile skills must include at least one of these keywords
      - `noneOf` string[], nullable — The LinkedIn profile skills must not include any of these keywords
    - `jobTitleKeywords` JobTitleKeywordsFilter
      - `allOf` string[], nullable — Match all of the keywords
      - `anyOf` string[], nullable — Match at least one of the keywords
      - `noneOf` string[], nullable — Match none of the keywords
      - `exactMatch` ExactMatchOptions
        - `anyOf` boolean — When true, anyOf terms must match the full job title exactly instead of substring matching.
        - `allOf` boolean — When true, allOf terms must match the full job title exactly instead of substring matching.
        - `noneOf` boolean — When true, noneOf terms must match the full job title exactly instead of substring matching.
    - `allJobDescriptions` AllJobDescriptionsFilter
      - `allOf` string[], nullable — Job descriptions must include all of these
      - `anyOf` string[], nullable — Job descriptions must include at least one of these
      - `noneOf` string[], nullable — Job descriptions must not include any of these
    - `currentJobDescription` CurrentJobDescriptionFilter
      - `allOf` string[], nullable — The current job description must include all of these
      - `anyOf` string[], nullable — The current job description must include at least one of these
      - `noneOf` string[], nullable — The current job description must not include any of these
    - `profileDescription` ProfileDescriptionFilter
      - `allOf` string[], nullable — The LinkedIn profile description must include all of these keywords
      - `anyOf` string[], nullable — The LinkedIn profile description must include at least one of these keywords
      - `noneOf` string[], nullable — The LinkedIn profile description must not include any of these keywords
    - `regions` string[], nullable — List of region codes to search for people.
    - `states` State[], nullable — List of states/regions to search for people (ISO-3166-2 region codes). Available abbreviation values are located at /v2/data-fields endpoint (region section).
      - `country` string, required — Alpha-2 ISO 3166 country code
      - `abbreviation` string, required — Valid state abbreviation. List available in the region section there: /v2/data-fields.
    - `excludeStates` State[], nullable — List of states/regions to exclude when searching for people (ISO-3166-2 region codes). Available abbreviation values are located at /v2/data-fields endpoint (region section).
      - `country` string, required — Alpha-2 ISO 3166 country code
      - `abbreviation` string, required — Valid state abbreviation. List available in the region section there: /v2/data-fields.
    - `excludeCountries` string[], nullable — List of country codes (alpha-2 ISO 3166) to exclude when searching for people.
    - `cities` PeopleCityFilter[], nullable — List of cities to search for people.
      - `city` string, required — City name
      - `country` string, nullable — Alpha-2 ISO 3166 country code
      - `region` State
        - `country` string, required — Alpha-2 ISO 3166 country code
        - `abbreviation` string, required — Valid state abbreviation. List available in the region section there: /v2/data-fields.
    - `excludeCities` PeopleCityFilter[], nullable — List of cities to exclude when searching for people.
      - `city` string, required — City name
      - `country` string, nullable — Alpha-2 ISO 3166 country code
      - `region` State
        - `country` string, required — Alpha-2 ISO 3166 country code
        - `abbreviation` string, required — Valid state abbreviation. List available in the region section there: /v2/data-fields.
    - `names` string[], nullable — Filter by names
    - `departments` Department[], nullable — Filter by departments. Available values are located at /v2/data-fields endpoint.<br>
    - `excludeDepartments` Department[], nullable — Exclude people by departments. Available values are located at /v2/data-fields endpoint.<br>
    - `fieldsExist` string[], nullable — Return records where specified fields exist
    - `fieldsNotExist` string[], nullable — Return records where specified fields do not exist
    - `changedPositionAfter` string, nullable — Return people who started a new job between the specified date (inclusive) and now
    - `changedPositionBefore` string, nullable — Return people who started a new currently active job before the specified date (inclusive)
    - `updatedWithinMonths` integer, nullable — Filter people updated within the last N months.
    - `connections` FromTo
      - `from` integer, nullable — Greater than or equal to
      - `to` integer, nullable — Less than or equal to
    - `followers` FromTo
      - `from` integer, nullable — Greater than or equal to
      - `to` integer, nullable — Less than or equal to
  - `companiesFilters` CompaniesFiltersV3
    - `lookalikeDomains` string[], nullable — Find domains similar to the provided
    - `includeDomains` string[], nullable — Only return specified domains
    - `excludeDomains` string[], nullable — Exclude specified domains from the results
    - `companySizes` PublicCompanySize[], nullable — Filter by company size ranges
    - `ecommerce` boolean, nullable — true -> returns only e-commerce companies<br>false -> excludes e-commerce companies<br>none -> returns everything
    - `yearFounded` FromTo
      - `from` integer, nullable — Greater than or equal to
      - `to` integer, nullable — Less than or equal to
    - `countriesCount` FromTo
      - `from` integer, nullable — Greater than or equal to
      - `to` integer, nullable — Less than or equal to
    - `revenues` Revenue[], nullable — Filter by revenue ranges
    - `employeeCountOcean` FromTo
      - `from` integer, nullable — Greater than or equal to
      - `to` integer, nullable — Less than or equal to
    - `mobileApps` FromTo
      - `from` integer, nullable — Greater than or equal to
      - `to` integer, nullable — Less than or equal to
    - `mobileAppsFilter` MobileAppsFilter
      - `count` FromTo
        - `from` integer, nullable — Greater than or equal to
        - `to` integer, nullable — Less than or equal to
      - `downloads` FromTo
        - `from` integer, nullable — Greater than or equal to
        - `to` integer, nullable — Less than or equal to
      - `releaseYear` FromTo
        - `from` integer, nullable — Greater than or equal to
        - `to` integer, nullable — Less than or equal to
    - `locationsCount` FromTo
      - `from` integer, nullable — Greater than or equal to
      - `to` integer, nullable — Less than or equal to
    - `departmentSizes` DepartmentSizeFilter[], nullable — Filter by the size of company departments. Valid range: 0-10,000,000
      - `from` integer, nullable — Greater than or equal to
      - `to` integer, nullable — Less than or equal to
      - `department` 'Accounting and Finance' | 'Board' | 'Business Support' | 'Customer Relations' | 'Design' | 'Editorial Personnel' | 'Engineering' | 'Founder/Owner' | 'Healthcare' | 'HR' | 'Legal' | 'Management' | 'Manufacturing' | 'Marketing and Advertising' | 'Operations' | 'PR and Communications' | 'Procurement' | 'Product' | 'Quality Control' | 'R&D' | 'Sales' | 'Security' | 'Supply Chain' | 'Other' | 'Education', required
    - `employeeCountLinkedin` FromTo
      - `from` integer, nullable — Greater than or equal to
      - `to` integer, nullable — Less than or equal to
    - `industries` IndustriesFilter
      - `industries` string[], required — Array of the industries to include
      - `mode` 'anyOf' | 'allOf' — [default] anyOf - match at least one of the industries<br>allOf - match all of the industries
    - `excludeIndustries` string[], nullable — Array of the industries to exclude
    - `industryCategories` IndustryCategoriesFilter
      - `industryCategories` string[], required — Array of the industry categories to include
      - `mode` 'anyOf' | 'allOf' — [default] anyOf - match at least one of the industry categories<br>allOf - match all of the industry categories
    - `excludeIndustryCategories` string[], nullable — Array of the industry categories to exclude
    - `linkedinIndustries` string[], nullable — Filter by Linkedin industries. This is OR filter. Available values are located at /v2/data-fields endpoint.<br>
    - `excludeLinkedinIndustries` string[], nullable — Array of Linkedin industries to exclude. Available values are located at /v2/data-fields endpoint.<br>
    - `fundingRound` FundingRoundFilter
      - `raised` FromTo
        - `from` integer, nullable — Greater than or equal to
        - `to` integer, nullable — Less than or equal to
      - `types` FundingRoundType[], nullable — List of funding round types
      - `date` FromToStringDate
        - `from` string, nullable — Date in YYYY-MM-DD format
        - `to` string, nullable — Date in YYYY-MM-DD format
    - `primaryLocations` LocationsFilter
      - `includeCountries` string[], nullable — Filter by all countries where the company has presence.<br>Must be provided as alpha-2 ISO 3166 country codes.
      - `excludeCountries` string[], nullable — Exclude companies that are present in the specified countries.<br>Must be provided as alpha-2 ISO 3166 country codes.
      - `includeRegions` State[], nullable — Filter by country regions — US states, Canadian provinces, etc. (if applicable). Available values are located at /v2/data-fields endpoint.
        - `country` string, required — Alpha-2 ISO 3166 country code
        - `abbreviation` string, required — Valid state abbreviation. List available in the region section there: /v2/data-fields.
      - `excludeRegions` State[], nullable — Exclude companies present in the specified regions — US states, Canadian provinces, etc. (if applicable). Available values are located at /v2/data-fields endpoint.
        - `country` string, required — Alpha-2 ISO 3166 country code
        - `abbreviation` string, required — Valid state abbreviation. List available in the region section there: /v2/data-fields.
      - `includeCities` CompaniesCityFilter[], nullable — Filter by cities
        - `city` string, required — City name
        - `country` string, nullable — Alpha-2 ISO 3166 country code
        - `region` State
          - `country` string, required — Alpha-2 ISO 3166 country code
          - `abbreviation` string, required — Valid state abbreviation. List available in the region section there: /v2/data-fields.
        - `postalCode` string, nullable — Filter by postal code
      - `excludeCities` CompaniesCityFilter[], nullable — Exclude companies that are present in the specified cities
        - `city` string, required — City name
        - `country` string, nullable — Alpha-2 ISO 3166 country code
        - `region` State
          - `country` string, required — Alpha-2 ISO 3166 country code
          - `abbreviation` string, required — Valid state abbreviation. List available in the region section there: /v2/data-fields.
        - `postalCode` string, nullable — Filter by postal code
      - `geolocation` GeolocationFilter
        - `latitude` number, required — Latitude of the location
        - `longitude` number, required — Longitude of the location
        - `radius` integer, required — Radius in meters
    - `otherLocations` LocationsFilter
      - `includeCountries` string[], nullable — Filter by all countries where the company has presence.<br>Must be provided as alpha-2 ISO 3166 country codes.
      - `excludeCountries` string[], nullable — Exclude companies that are present in the specified countries.<br>Must be provided as alpha-2 ISO 3166 country codes.
      - `includeRegions` State[], nullable — Filter by country regions — US states, Canadian provinces, etc. (if applicable). Available values are located at /v2/data-fields endpoint.
        - `country` string, required — Alpha-2 ISO 3166 country code
        - `abbreviation` string, required — Valid state abbreviation. List available in the region section there: /v2/data-fields.
      - `excludeRegions` State[], nullable — Exclude companies present in the specified regions — US states, Canadian provinces, etc. (if applicable). Available values are located at /v2/data-fields endpoint.
        - `country` string, required — Alpha-2 ISO 3166 country code
        - `abbreviation` string, required — Valid state abbreviation. List available in the region section there: /v2/data-fields.
      - `includeCities` CompaniesCityFilter[], nullable — Filter by cities
        - `city` string, required — City name
        - `country` string, nullable — Alpha-2 ISO 3166 country code
        - `region` State
          - `country` string, required — Alpha-2 ISO 3166 country code
          - `abbreviation` string, required — Valid state abbreviation. List available in the region section there: /v2/data-fields.
        - `postalCode` string, nullable — Filter by postal code
      - `excludeCities` CompaniesCityFilter[], nullable — Exclude companies that are present in the specified cities
        - `city` string, required — City name
        - `country` string, nullable — Alpha-2 ISO 3166 country code
        - `region` State
          - `country` string, required — Alpha-2 ISO 3166 country code
          - `abbreviation` string, required — Valid state abbreviation. List available in the region section there: /v2/data-fields.
        - `postalCode` string, nullable — Filter by postal code
      - `geolocation` GeolocationFilter
        - `latitude` number, required — Latitude of the location
        - `longitude` number, required — Longitude of the location
        - `radius` integer, required — Radius in meters
    - `webTraffic` WebTrafficFilter
      - `visits` FromTo
        - `from` integer, nullable — Greater than or equal to
        - `to` integer, nullable — Less than or equal to
      - `views` FromTo
        - `from` integer, nullable — Greater than or equal to
        - `to` integer, nullable — Less than or equal to
    - `socialMedias` SocialMediasFilterV3
      - `medias` AllAnyNoneFilterSocialMedia
        - `anyOf` string[], nullable — The filter should match **any** of the specified values.
        - `allOf` string[], nullable — The filter should match **all** of the specified values.
        - `noneOf` string[], nullable — The filter should match **none** of the specified values.
      - `minCount` integer, nullable — Return companies that are present in more than `n` social networks
    - `technologies` TechnologiesFilterV3
      - `apps` AllAnyNoneFilter
        - `anyOf` string[], nullable — The filter should match **any** of the specified values.
        - `allOf` string[], nullable — The filter should match **all** of the specified values.
        - `noneOf` string[], nullable — The filter should match **none** of the specified values.
      - `categories` AllAnyNoneFilter
        - `anyOf` string[], nullable — The filter should match **any** of the specified values.
        - `allOf` string[], nullable — The filter should match **all** of the specified values.
        - `noneOf` string[], nullable — The filter should match **none** of the specified values.
    - `keywords` AllAnyNoneFilter
      - `anyOf` string[], nullable — The filter should match **any** of the specified values.
      - `allOf` string[], nullable — The filter should match **all** of the specified values.
      - `noneOf` string[], nullable — The filter should match **none** of the specified values.
    - `minRelevance` 'A' | 'B' | 'C', nullable — Filter by min relevance (A - the most relevant).
    - `maxRelevance` 'A' | 'B' | 'C', nullable — Filter by max relevance (A - the most relevant). Use combination of min_relevance: "B" and max_relevance: "B" to get only results with the "B" relevance
    - `headcountGrowth` HeadcountGrowthFilter
      - `asPercentage` boolean, required — true -> filter on the percentage value of the headcount growth<br>false -> filter on the absolute value of the headcount growth<br>
      - `growthRange` FromToFloat, required
        - `from` number, nullable — Greater than or equal to
        - `to` number, nullable — Less than or equal to
      - `months` 'Three months' | 'Six months' | 'Twelve months', required
    - `departmentHeadcountGrowth` DepartmentGrowthAllAnyFilter
      - `anyOf` DepartmentGrowthFilter[], nullable — The result should match **any** of the department headcount growth filters.
        - `asPercentage` boolean, required — true -> filter on the percentage value of the headcount growth<br>false -> filter on the absolute value of the headcount growth<br>
        - `growthRange` FromToFloat, required
          - `from` number, nullable — Greater than or equal to
          - `to` number, nullable — Less than or equal to
        - `months` 'Three months' | 'Six months' | 'Twelve months', required
        - `department` 'Accounting and Finance' | 'Board' | 'Business Support' | 'Customer Relations' | 'Design' | 'Editorial Personnel' | 'Engineering' | 'Founder/Owner' | 'Healthcare' | 'HR' | 'Legal' | 'Management' | 'Manufacturing' | 'Marketing and Advertising' | 'Operations' | 'PR and Communications' | 'Procurement' | 'Product' | 'Quality Control' | 'R&D' | 'Sales' | 'Security' | 'Supply Chain' | 'Other' | 'Education', required
      - `allOf` DepartmentGrowthFilter[], nullable — The result should match **all** of the he department headcount growth filters.
        - `asPercentage` boolean, required — true -> filter on the percentage value of the headcount growth<br>false -> filter on the absolute value of the headcount growth<br>
        - `growthRange` FromToFloat, required
          - `from` number, nullable — Greater than or equal to
          - `to` number, nullable — Less than or equal to
        - `months` 'Three months' | 'Six months' | 'Twelve months', required
        - `department` 'Accounting and Finance' | 'Board' | 'Business Support' | 'Customer Relations' | 'Design' | 'Editorial Personnel' | 'Engineering' | 'Founder/Owner' | 'Healthcare' | 'HR' | 'Legal' | 'Management' | 'Manufacturing' | 'Marketing and Advertising' | 'Operations' | 'PR and Communications' | 'Procurement' | 'Product' | 'Quality Control' | 'R&D' | 'Sales' | 'Security' | 'Supply Chain' | 'Other' | 'Education', required
    - `updatedWithinMonths` integer, nullable — Filter companies updated within the last N months.
    - `fieldsExist` string[], nullable — Return records where specified fields exist
    - `fieldsNotExist` string[], nullable — Return records where specified fields do not exist
    - `companyMatchingMode` 'precise' | 'broad', nullable — Controls how strictly companies are matched when using lookalike_domains. "precise" (default): Matches companies with similar products/services using semantic similarity. "broad": Matches companies within the same industries, casting a wider net for results.
  - `peoplePerCompany` integer, nullable — Number of people to return per company. If you want to return all people from a company, don't set this value.
  - `jobTitleThreshold` number, nullable — Threshold for job title similarity. The value must be between 0 and 1. Default is 0.8
  - `searchAfter` string, nullable — Use `searchAfter` returned by the previous request to get the next page.
  - `fields` union[], nullable — Fields to return in the Person objects. Only requesting the fields that are needed will use less bandwidth and result in faster responses. If not specified, the following default fields are returned: `id`, `domain`, `name`, `firstName`, `lastName`, `country`, `state`, `location`, `linkedinUrl`, `seniorities`, `departments`, `photo`, `jobTitle`, `jobTitleEnglish`, `currentJobDescription`, `experiences`, `summary`, `skills`, `headline`, `updatedAt`, `connectionsCount`, `followersCount`, `company.revenue`, `company.peopleCount`, `company.industries`, `company.technologies`, `company.latestFundingRound`.
    - union
      - 'id' | 'domain' | 'name' | 'firstName' | 'lastName' | 'country' | 'state' | 'location' | 'linkedinUrl' | 'seniorities' | 'departments' | 'subDepartments' | 'photo' | 'jobTitle' | 'jobTitleEnglish' | 'currentJobDescription' | 'experiences' | 'experiences.domain' | 'experiences.jobTitle' | 'experiences.dateFrom' | 'experiences.dateTo' | 'experiences.description' | 'experiences.linkedinCompanyHandle' | 'summary' | 'skills' | 'email' | 'email.address' | 'updatedAt' | 'connectionsCount' | 'followersCount' | 'headline'
      - 'company.revenue' | 'company.peopleCount' | 'company.industries' | 'company.technologies' | 'company.latestFundingRound'

## Response `200`

Successful Response

- LookalikePeopleResultV3
  - `people` LookalikePerson[], required
    - `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
    - `subDepartments` SubDepartment[], nullable — Sub-departments computed from the job title of the person. A sub-department is a narrower version of a department, for example software development within engineering. The order does not pair up with `departments`, so use /v2/data-fields to see which department a sub-department belongs to.
    - `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<br>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)
  - `detail` string, required — Status text
  - `lookalikePeopleStatuses` LookalikePeopleStatuses
    - `successfulPeople` string[], nullable — People that are found in the database
    - `notFoundPeople` string[], nullable — People that are not found in the database
    - `triggeredDomainPeople` string[], nullable — People linked to a company that was not crawled
    - `missingCompanyInformationPeople` string[], nullable — People linked to a company that is missing necessary data
  - `total` integer, nullable — Total number of results of the search, accessible with pagination.
  - `searchAfter` string, nullable — Used for pagination. Use `searchAfter` returned by this request in the next request to get the next page of search results.
  - `redirectMap` object, nullable — Mapping of original domains passed in filters to their redirected domains.
  - `creditsUsed` number, required — Number of credits charged for this request.
  - `includeDomainsStatuses` object, nullable — Domains from `includeDomains` filter that were not found in the search results, along with the reason

## Other responses

- `400` — Bad Request
- `402` — Payment Required
- `403` — Forbidden
- `404` — Not found
- `422` — Validation Error

## Changes

- **2026-09-01** `a5d5c0530873` — 2 info
  - added the new `subDepartments` enum value to the request property `fields/items/anyOf[subschema #1: PersonField]/`
  - added the optional property `people/items/subDepartments` to the response with the `200` status
- **2026-08-25** `505121e48722` — 1 info
  - added the new optional request property `peopleFilters/jobTitleKeywords/exactMatch`
- **2026-08-24** `7be4c13a1cf6` — 5 warning, 9 info
  - 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`
  - …10 more
- **2026-07-26** `0f900a1e318f` — 2 info
  - the `companiesFilters/otherLocations/geolocation/radius` request property's max was increased from `500000.00` to `1000000.00`
  - the `companiesFilters/primaryLocations/geolocation/radius` request property's max was increased from `500000.00` to `1000000.00`

[Change history](https://skmtc.dev/ocean/apis/ocean-io-api-documentation/changes/v3/search/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/a5d5c0530873/schema)