Skip to main content
GET
/
api
/
investors
List investors with filters
curl --request GET \
  --url https://api.example.com/api/investors \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": 123,
      "uuid": "<string>",
      "type": "<string>",
      "name": "<string>",
      "tagline": "<string>",
      "image": "<string>",
      "dealroom_url": "<string>",
      "website": "<string>",
      "website_domain": "<string>",
      "launch_year": 123,
      "employee_count": 123,
      "hq_country": "<string>",
      "hq_city": "<string>",
      "lat": 123,
      "lon": 123,
      "tags": [
        {
          "id": 123,
          "name": "<string>",
          "type": "<string>"
        }
      ],
      "investor_types": [
        {
          "id": 123,
          "name": "<string>",
          "code": "<string>"
        }
      ],
      "investor_stages": [
        {
          "id": 123,
          "name": "<string>",
          "code": "<string>"
        }
      ]
    }
  ],
  "page": {
    "limit": 123,
    "offset": 123,
    "total": 123
  }
}

Authorizations

Authorization
string
header
required

Auth0 JWT access token

Query Parameters

filter
string

Filter expression for investors using nested syntax.

Examples:

  • Single: total_invested_usd[gte]:1000000
  • AND: and(total_invested_usd[gte]:1000000,location[eq]:233)
  • OR: or(investor_type[eq]:vc,investor_type[eq]:corporate)

Operators: eq, neq, gt, gte, lt, lte, in_any, nin_any in_all / nin_all are only available on repeated related-record filters. Legacy aliases: in → in_any, nin → nin_any (deprecated, prefer canonical names). Default ref: 'entity' (can be omitted for entity filters)

Example:

"and(total_invested_usd[gte]:1000000,location[eq]:233)"

limit
string

Number of results to return (1-500, default 25)

Example:

"25"

offset
string
Example:

"0"

sort
string
Pattern: ^-?[\w,]+$
Example:

"-total_investments_count"

include_total
enum<string>
Available options:
true,
false
Example:

"true"

portfolio_count_tag
string

Pipe-separated tag IDs to count matching portfolio investments. Enables the portfolio_match_count sort key and match_count response field.

Pattern: ^\d+(\|\d+)*$
Example:

"22680"

portfolio_count_location
string

Pipe-separated location IDs to count matching portfolio investments. Enables the portfolio_match_count sort key and match_count response field.

Pattern: ^\d+(\|\d+)*$
Example:

"165"

Response

List of investors

data
object[]
required
page
object
required