Skip to main content
GET
/
api
/
data
/
founders
List founders
curl --request GET \
  --url https://api-next.dealroom.co/api/data/founders \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "uuid": "1a2b3c4d-5e6f-7890-1234-567890abcdef",
      "name": "Patrick Collison",
      "tagline": "Co-founder and CEO of Stripe.",
      "image": "https://images.dealroom.co/people/patrick-collison.jpg",
      "dealroom_url": "https://app.dealroom.co/people/patrick-collison",
      "gender": "male",
      "is_serial_founder": true,
      "is_super_founder": true,
      "is_promising_founder": false,
      "is_strong_founder": true,
      "launch_year": 2010,
      "signal_rating": 123,
      "founded_companies_total_funding": 123,
      "hq_country": "United States",
      "hq_city": "San Francisco",
      "tags": [
        {
          "id": 123,
          "name": "<string>",
          "type": "<string>"
        }
      ],
      "education": [
        {
          "university_uuid": "<string>",
          "university_name": "<string>",
          "degree": "<string>",
          "year_start": 123,
          "year_end": 123,
          "majors": [
            "<string>"
          ]
        }
      ],
      "universities": [
        {
          "id": 123,
          "year_start": 123,
          "year_end": 123,
          "degree": {
            "id": 123,
            "name": "<string>"
          },
          "majors": [
            {
              "id": 123,
              "name": "<string>"
            }
          ],
          "university": {
            "uuid": "<string>",
            "name": "<string>",
            "image": "<string>",
            "hq_city": "<string>",
            "hq_country": "<string>"
          }
        }
      ],
      "companies": [
        {
          "entity_uuid": "<string>",
          "entity_name": "<string>",
          "image": "<string>",
          "hq_city": "<string>",
          "hq_country": "<string>",
          "total_funding": 123,
          "latest_valuation": 123,
          "latest_valuation_year": 123,
          "latest_valuation_month": 123,
          "signal_rating": 123,
          "sector_tags": [
            {
              "id": 123,
              "name": "<string>"
            }
          ],
          "industries": [
            {
              "id": 123,
              "name": "<string>"
            }
          ],
          "is_founder": true,
          "is_executive": true,
          "is_partner": true,
          "is_past": true,
          "raw_title": "<string>",
          "titles": [
            {
              "name": "<string>"
            }
          ],
          "year_start": 123,
          "year_end": 123
        }
      ],
      "backgrounds": [
        {
          "id": 123,
          "name": "<string>"
        }
      ]
    }
  ],
  "page": {
    "limit": 123,
    "offset": 123,
    "next_cursor": "<string>",
    "prev_cursor": "<string>",
    "total": 123,
    "capped": true,
    "ecosystem": "<string>"
  },
  "currency": "EUR"
}

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.

Query Parameters

filter
string

Filter expression for founders using nested syntax.

Examples:

  • Single: is_super_founder[eq]:true
  • AND: and(location_country[eq]:233,is_promising_founder[eq]:true)

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(is_super_founder[eq]:true,location_country[eq]:233)"

limit
integer<int32>
default:25

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

Required range: 1 <= x <= 500
Example:

25

offset
integer<int32>
default:0

Number of results to skip before returning data. Combine with limit for offset-based pagination.

Required range: x >= 0
Example:

0

cursor
string

Opaque cursor token from a previous response's page.next_cursor or page.prev_cursor. Round-trip it as-is — do not decode or modify.

Example:

"eyJ2IjoxLCJkIjoibmV4dCJ9"

sort
string

Sort by one or more keys. Prefix with - for descending order; comma-separated for multi-key sorts.

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

"-launch_date"

include_total
boolean

Pass true to include page.total (the matching record count) in the response. Default omits the total to avoid a count query.

Example:

true

currency
string

ISO 4217 currency code for monetary field conversion. Defaults to USD.

Example:

"EUR"

Response

List of founders

data
object[]
required
page
object
required
currency
string
required

Currency the founder monetary fields are expressed in (default USD).

Example:

"EUR"