latestOpenAPI 3.0.12026-08-17127235413.6 KB

eab6a2753503

Companies

Company Search

Retrieves companies matching the specified criteria

get/companies/search

Query parameters

companyNamesstring

Accepts company names, pbIds, websites, and tickers. Returns a list of companies that are an exact match. Use a comma to separate multiple values

ownershipStatusstring

Companies can be found by their <a href="https://my.pitchbook.com/api/lookup-tables/Companies#OWNERSHIP_STATUS_TREE" target="_blank">ownership status code</a>

backingStatusstring

Companies can be found by their <a href="https://my.pitchbook.com/api/lookup-tables/Companies#BACKING_STATUS_TREE" target="_blank">backing status code</a>

businessStatusstring

Companies can be found by their <a href="https://my.pitchbook.com/api/lookup-tables/Companies#BUSINESS_STATUS_TREE" target="_blank">business status code</a>

citystring

Search for companies by their city location

stateProvincestring

Search for companies by their <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>

countrystring

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

postCodestring

Search for companies by their postcode, included to support searching for both US postal code and foreign

locationTypestring

Search for companies by additional parameter 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

dateFoundedstring

Companies can be found by founding date. Search for companies founded after a certain date using the > operator, companies founded before a certain date using the < operator and companies founded between 2 dates using the ^ operator. Format: YYYY-MM-DD

keywordsstring

Search for companies by keywords associated with them or appearing in their business descriptions. If two or more keywords are specified, the OR operator is applied. Only one industry classification can be used at a time. This parameter cannot be combined with parameters from other industry classifications

industrystring

Companies can be found by the <a href="https://my.pitchbook.com/api/lookup-tables/Industries, Verticals & Emerging Spaces#INDUSTRY_TREE" target="_blank">industry code</a>. Only one industry classification can be used at a time. This parameter cannot be combined with parameters from other industry classifications

verticalsstring

Companies can be found by the <a href="https://my.pitchbook.com/api/lookup-tables/Industries, Verticals & Emerging Spaces#VERTICAL_TREE" target="_blank">vertical code</a>. Only one industry classification can be used at a time. This parameter cannot be combined with parameters from other industry classifications

industryAndVerticalstring

When using any combination of industry, verticals, and emergingSpaces parameters, "OR" logic is used by default. To use "AND" logic, set this parameter to True.

emergingSpacesstring

Emerging spaces are defined by PB analysts for specific products or technological innovations that are growing in popularity. These spaces are dynamic and change over time. Companies can be found by the <a href="https://my.pitchbook.com/api/lookup-tables/Industries, Verticals & Emerging Spaces#EMERGING_SPACES_TREE" target="_blank">emerging space code</a>. Only one industry classification can be used at a time. This parameter cannot be combined with parameters from other industry classifications

gecsSectorstring

Companies can be found by the <a href="https://my.pitchbook.com/api/lookup-tables/Industries, Verticals & Emerging Spaces#GECS_SECTOR_TREE" target="_blank">GECS sector code</a>. Only one industry classification can be used at a time. This parameter cannot be combined with parameters from other industry classifications

gecsIndustryGroupstring

Companies can be found by the <a href="https://my.pitchbook.com/api/lookup-tables/Industries, Verticals & Emerging Spaces#GECS_INDUSTRY_GROUP_TREE" target="_blank">GECS industry group code</a>. Only one industry classification can be used at a time. This parameter cannot be combined with parameters from other industry classifications

gecsIndustrystring

Companies can be found by the <a href="https://my.pitchbook.com/api/lookup-tables/Industries, Verticals & Emerging Spaces#GECS_INDUSTRY_TREE" target="_blank">GECS industry code</a>. Only one industry classification can be used at a time. This parameter cannot be combined with parameters from other industry classifications

dealTypestring

Find companies with a specific <a href="https://my.pitchbook.com/api/lookup-tables/Deals#DEAL_TYPE_TREE" target="_blank">deal type code</a>

dealStatusstring

Distinguish between failed, upcoming, completed deals and more. Pass a <a href="https://my.pitchbook.com/api/lookup-tables/Deals#DEAL_STATUS_TREE" target="_blank">deal status code</a>

dealSizestring

Find companies who have had a deal of a certain size. Search for companies with a deal larger than an amount using the > operator, companies with a deal smaller than a certain amount using the < operator and companies with a deal size in a range using the ^ operator. Amounts in millions

includeDealsWithoutDealSizestring

Include companies without a known deal size. Set this parameter as True only when Deal Size parameter is applied. False by default

excludeDealsWithoutDealSizestring

Exclude companies without a known deal size. Set this parameter as True only when Deal Size parameter is not applied. False by default

dealDatestring

Find companies who have had a deal within a certain time frame. Search for companies with a deal after a certain date using the > operator, companies with a deal before a certain date using the < operator and companies with a deal between 2 dates using the ^ operator. Format: YYYY-MM-DD

totalRaisedstring

Find companies by the total amount of money they have raised to date in millions. Use the > operator to find companies that have raised more than a certain value, use the < to find companies who have raised less than a certain value and the ^ operator to search within a range. Amounts in millions

investorNamesstring

Accepts investor names, pbIds, websites, and tickers. Returns a list of companies that have been invested in by specified investors that are an exact match to the input. Use a comma to separate multiple values

partialExitstring

Find companies who have had a deal with partial investor's exit within them. To use this parameter set it as True

fullExitstring

Find companies who have had a deal with full investor's exit within them. To use this parameter set it as True

exitTypestring

Find companies with a specific exit of deal with investor's exit within them. Pass a <a href="https://my.pitchbook.com/api/lookup-tables/Deals#EXIT_TYPE_TREE" target="_blank">exit type code</a>

exitStatusstring

Distinguish between failed, upcoming, completed exits and more. Pass a <a href="https://my.pitchbook.com/api/lookup-tables/Deals#DEAL_STATUS_TREE" target="_blank">deal status code</a>

exitSizestring

Find companies who have had a deal with investor's exit within them of a certain size. Search for companies with an exit larger than an amount using the > operator, companies with an exit smaller than a certain amount using the < operator and companies with an exit size in a range using the ^ operator. Amounts in millions

exitDatestring

Find companies who have had a deal within a certain time frame. Search for companies with a deal after a certain date using the > operator, companies with a deal before a certain date using the < operator and companies with a deal between 2 dates using the ^ operator. Format: YYYY-MM-DD

revenuestring

Find companies that have a certain amount of revenue. Search for companies with more revenue than an amount using the > operator, companies with less revenue than an amount using the < operator or companies within a range using the ^ operator. Amounts in millions

onlyMostRecentTransactionstring

Find companies by their most recent deal. To use this parameter set it as True

employeeCountstring

Find companies by their current employee count. Search for companies with a headcount larger than a value using the > operator, companies with a headcount smaller than a value using the < operator and companies with a headcount in a range using the ^ operator

totalPatentDocumentsstring

Add this parameter to filter based on total patents count. Use the > operator to indicate a minimum value, the < operator to indicate a maximum value, and a range of two values with the ^ operator.

activePatentDocumentsstring

Add this parameter to filter based on active patents count. Use the > operator to indicate a minimum value, the < operator to indicate a maximum value, and a range of two values with the ^ operator.

pendingPatentDocumentsstring

Add this parameter to filter based on pending patents count. Use the > operator to indicate a minimum value, the < operator to indicate a maximum value, and a range of two values with the ^ operator.

totalPatentFamiliesstring

Add this parameter to filter based on patent family count. Use the > operator to indicate a minimum value, the < operator to indicate a maximum value, and a range of two values with the ^ operator.

inactiveFamilyDocumentsstring

Add this parameter to filter based on inactive documents count. Use the > operator to indicate a minimum value, the < operator to indicate a maximum value, and a range of two values with the ^ operator.

patentsExpiringNextYearstring

Add this parameter to filter based on count of patents expiring next year. Use the > operator to indicate a minimum value, the < operator to indicate a maximum value, and a range of two values with the ^ operator.

patentFilingLocationstring

Patents can be found by their <a href="https://my.pitchbook.com/api/lookup-tables/Patents#FILING_LOCATION_TREE" target="_blank">filing location</a>. Use a comma to separate multiple values

currencystring

Specify the currency that your other parameters, such as dealSize, are entered as. It depends on the <a href="https://my.pitchbook.com/api/lookup-tables/Currency#CURRENCY_CODE_TREE" target="_blank">currency</a> in user preferences

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