latestOpenAPI 3.0.12026-08-17127235413.6 KB

eab6a2753503

People

People Search

Retrieves people along with the companies associated with the person

get/people/search

Query parameters

firmNamesstring

Accepts firm names, pbIds, websites, and tickers. Returns a list of persons from all entities that are an exact match. Use a comma to separate multiple values

personNamesstring

Accepts person names, and pbIds. Returns a list of persons that are an exact match. Use a comma to separate multiple values

biographystring

Search for people by words and phrases in their biography text

universitystring

Find people by their graduating institution

firmTypestring

Find people associated with a specific <a href="https://my.pitchbook.com/api/lookup-tables/People#PERSON_FIRM_TYPE_TREE" target="_blank">firm type code</a>

positionLevelstring

Find people by their <a href="https://my.pitchbook.com/api/lookup-tables/People#PERSON_POSITION_TREE" target="_blank">position level code</a>

positionTitlestring

Find people by the keywords related to their positions

primaryPositionOnlystring

Search for people by additional parameter concerning their positions. Set this parameter as True and use in pair with positionTitle option

departmentstring

Find people within an organization by the department they work in. Pass a <a href="https://my.pitchbook.com/api/lookup-tables/People#PERSON_POSITION_DEPARTMENT_TREE" target="_blank">position department code</a>

statusstring

Find people by position status (active or former)

genderstring

Find people by gender (male or female)

industrystring

People can be found by <a href="https://my.pitchbook.com/api/lookup-tables/Industries, Verticals & Emerging Spaces#INDUSTRY_TREE" target="_blank">industry code</a> of the companies associated with them

verticalsstring

People can be found by <a href="https://my.pitchbook.com/api/lookup-tables/Industries, Verticals & Emerging Spaces#VERTICAL_TREE" target="_blank">vertical code</a> of the companies associated with them

industryAndVerticalstring

When using both industry and vertical parameters, "OR" logic is used by default. To use "AND" logic, set this parameter to True. Set this parameter in pair with industry and vertical options

citystring

Search for people by city of their entities

stateProvincestring

Search for people by <a href="https://my.pitchbook.com/api/lookup-tables/Location#US_STATE_TREE" target="_blank">state code</a> or <a href="https://my.pitchbook.com/api/lookup-tables/Location#CANADIAN_PROVINCE_TREE" target="_blank">province code</a> of their entities

countrystring

Search for people by <a href="https://my.pitchbook.com/api/lookup-tables/Location#COUNTRY_TREE" target="_blank">country code</a> of their entities

postCodestring

Search for people by postcodes of their entities

locationTypestring

Search for people by additional parameter concerning the entities specifying HQ Only (HQ_ONLY), Non-HQ Only (NON_HQ_ONLY) or any office location (ANY) values. Set this parameter in pair with city, stateProvince, country, postCode options

firstNamestring

Find people by first name

lastNamestring

Find people by last name

emailstring

Find people by email

domainstring

Find people by domain

pagestring

Results are returned so that they can be paged through. Set this parameter to increment the page

perPagestring

How many returned results show on page

Response

OK