Skip to main content
GET
/
api
/
reference
/
filters
/
{key}
/
values
List filter values
curl --request GET \
  --url https://api-next.dealroom.co/api/reference/filters/{key}/values \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": 42,
      "code": "industry/fintech",
      "name": "Fintech",
      "entity_count": 1200,
      "type": "industry"
    },
    {
      "id": 87,
      "code": "industry/financial-services",
      "name": "Financial Services",
      "entity_count": 890,
      "type": "industry"
    }
  ],
  "page": {
    "total": 2,
    "limit": 100,
    "offset": 0
  }
}

Authorizations

​
Authorization
string
header
required

OAuth2 client-credentials flow against the Dealroom Auth0 tenant. Use the client_id / client_secret from a Programmatic API key. Tokens are valid for 24h — Swagger UI will reuse the same token across operations.

Path Parameters

​
key
string
required
Example:

"tag_id"

Query Parameters

​
q
string

Fuzzy search (min 2 chars)

Minimum string length: 2
Example:

"fintech"

​
semantic
string

Semantic ranking phrase — ranks values by gemini-embedding-001 cosine distance instead of lexical search. Tag dimensions only; ignored elsewhere.

Required string length: 2 - 500
Example:

"fintech lending"

​
type
string

Sub-type filter (e.g. industry for tags, country for locations)

Example:

"industry"

​
limit
string

Results per page (1-1000, default 100)

Example:

"100"

​
offset
string
Example:

"0"

​
include
string

Comma-separated enrichments: geo, description

Example:

"geo"

​
ids
string

Pipe-separated IDs to always include

Pattern: ^[\w-]+(\|[\w-]+)*$
Example:

"42|123"

​
filter
string

Serialized filter expression (same format as entity list endpoints). When provided, entity_count reflects how many results remain with these filters applied.

Example:

"and(hq_country[eq]:1)"

​
scope
enum<string>

Filter scope (same as discovery/search). Aligns contextual entity_count with the scoped list endpoint — relationship-path keys, defaults, and baselines. Defaults to companies.

Available options:
companies,
investors,
transactions,
people,
universities,
news,
jobs
Example:

"companies"

Response

Filter values with entity counts

​
data
object[]
required
​
page
object
required