Skip to main content
GET
/
api
/
founders
List founders with filters
curl --request GET \
  --url https://api.example.com/api/founders \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": 123,
      "uuid": "<string>",
      "name": "<string>",
      "tagline": "<string>",
      "image": "<string>",
      "dealroom_url": "<string>",
      "gender": "<string>",
      "is_serial_founder": true,
      "is_super_founder": true,
      "is_promising_founder": true,
      "is_strong_founder": true,
      "launch_year": 123,
      "hq_country": "<string>",
      "hq_city": "<string>",
      "tags": [
        {
          "id": 123,
          "name": "<string>",
          "type": "<string>"
        }
      ],
      "education": [
        {
          "university_id": 123,
          "university_name": "<string>",
          "degree": "<string>",
          "year_start": 123,
          "year_end": 123,
          "majors": [
            "<string>"
          ]
        }
      ],
      "companies": [
        {
          "entity_id": 123,
          "entity_name": "<string>",
          "is_founder": true,
          "is_past": true,
          "raw_title": "<string>",
          "year_start": 123,
          "year_end": 123
        }
      ],
      "backgrounds": [
        {
          "id": 123,
          "name": "<string>"
        }
      ]
    }
  ],
  "page": {
    "limit": 123,
    "offset": 123,
    "total": 123
  }
}

Authorizations

Authorization
string
header
required

Auth0 JWT access token

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
string

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

Example:

"25"

offset
string
Example:

"0"

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

"-launch_year"

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

"true"

Response

List of founders

data
object[]
required
page
object
required