Skip to main content
Filters are passed as query parameters using bracket notation: 
filter[<field>][<operator>]=<value>

​
Operators

OperatorDescriptionExample
eqExact matchfilter[country][eq]=United Kingdom
neqNot equalfilter[country][neq]=United States
gtGreater thanfilter[launch_year][gt]=2015
gteGreater than or equalfilter[launch_year][gte]=2020
ltLess thanfilter[launch_year][lt]=2025
lteLess than or equalfilter[valuation][lte]=1000000000
inAny of (comma-separated)filter[country][in]=UK,US,DE
ninNone of (comma-separated)filter[status][nin]=closed,merged
likePartial string matchfilter[name][like]=acme

​
Examples

​
Filter by HQ country

curl "https://api.dealroom.co/api/entities?sort=-launch_year&filter[location_country][eq]=United+Kingdom" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "User-Agent: MyApp/1.0 (you@example.com)" \
  -H "X-Client-Id: YOUR_CLIENT_ID"

​
Filter by industry

curl "https://api.dealroom.co/api/entities?sort=-valuation&filter[industries][in]=fintech,payments" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "User-Agent: MyApp/1.0 (you@example.com)" \
  -H "X-Client-Id: YOUR_CLIENT_ID"

​
Combine multiple filters

Filters are ANDed together: 
curl "https://api.dealroom.co/api/entities?sort=-launch_year\
&filter[location_country][eq]=Germany\
&filter[launch_year][gte]=2018\
&filter[total_funding][gte]=1000000" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "User-Agent: MyApp/1.0 (you@example.com)" \
  -H "X-Client-Id: YOUR_CLIENT_ID"

​
Location filters

Location filters support an optional location_role parameter to specify which location type to match against:
RoleDescription
hqHeadquarters only
foundingLocation at founding
officeAny registered office
anyAll of the above (default)
# Companies headquartered in Berlin
filter[location_city][eq]=Berlin&filter[location_role][eq]=hq

​
Sorting

Use the sort parameter with a field name. Prefix with - for descending order. 
# Sort by launch year, newest first
sort=-launch_year

# Sort by total funding, highest first
sort=-total_funding
sort is required on list endpoints.

​
Available filters

Browse the API Reference for the complete list of filters available on each endpoint. Common filters across entity endpoints include:
  • location_country, location_city, location_continent
  • industries, technologies, tags
  • launch_year, total_funding, valuation
  • employee_count, growth_stage
  • has_funding, is_recently_funded