Founders and Investors API

Retrieve people with advanced filtering, pagination, sorting, and optional AI-powered semantic search.

POST /people

cURL

empty

curl --request POST \
  --url https://www.tryfundable.ai/api/v1/people \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "page_size": 5
}'

200

{
  "success": true,
  "data": {
    "people": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "name": "Jane Doe",
        "title": "CEO",
        "linkedin_url": "<string>",
        "crunchbase_url": "<string>",
        "twitter_url": "<string>",
        "location": "San Francisco, CA",
        "city": "<string>",
        "country_code": "US",
        "about": "<string>",
        "is_founder": true,
        "current_company": {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "name": "<string>",
          "permalink": "<string>",
          "domain": "<string>"
        },
        "employment_history": [
          {
            "title": "<string>",
            "company_name": "<string>",
            "company_id": "<string>",
            "company_url": "<string>",
            "location": "<string>",
            "description": "<string>",
            "start_date": "2023-12-25",
            "end_date": "2023-12-25",
            "is_current": true
          }
        ],
        "education_history": [
          {
            "school_name": "<string>",
            "school_id": "<string>",
            "school_url": "<string>",
            "degree": "<string>",
            "field_of_study": "<string>",
            "start_date": "<string>",
            "end_date": "<string>",
            "description": "<string>"
          }
        ],
        "is_investor": true,
        "is_angel": true,
        "has_led_deal": true,
        "investment_firms": [
          {
            "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "name": "<string>",
            "permalink": "<string>",
            "domain": "<string>",
            "deal_count": 123,
            "last_deal_date": "2023-12-25"
          }
        ],
        "investor_highlights": {
          "total_deal_count": 12,
          "lead_deal_count": 123,
          "deal_count_last_12_months": 123,
          "lead_deal_count_last_12_months": 123,
          "most_recent_deal_date": "2023-12-25",
          "top_industries": [
            {
              "name": "<string>",
              "permalink": "<string>",
              "count": 123
            }
          ],
          "top_locations": [
            {
              "name": "<string>",
              "full_name": "<string>",
              "permalink": "<string>",
              "type": "CITY",
              "count": 123
            }
          ],
          "top_round_types": [
            {
              "type": "SERIES_A",
              "count": 123
            }
          ]
        },
        "filtered_deal_count": 123,
        "filtered_lead_count": 123,
        "filtered_most_recent_date": "2023-12-25"
      }
    ]
  },
  "meta": {
    "total_count": 1250,
    "page": 0,
    "page_size": 25,
    "credits_used": 25,
    "credit_source": "monthly",
    "monthly_credits_remaining": 990,
    "purchased_credits_remaining": 500
  },
  "message": "<string>"
}

Filtering by location, industry, or round type? Use exact permalinks — a wrong value for locations, industries, or super_categories returns zero results with no error. Resolve them via /location/search and /industry/search first. See Filtering & Permalinks.

Authorizations

Authorization · string · header · required

API key provided as a Bearer token

Body

application/json

person_type · enum<string> · default: any

Restrict results to one population. company returns only people with a current employer (founders, executives, employees). investor returns only people who invest. any (default) returns the union — anyone matching the other filter blocks regardless of population.

Available options: company, investor, any

Example:

"company"

identifiers · object

Look up specific people by identifier

Show child attributes

person · object

Person attribute filters

Show child attributes

company · object

Current-employer attribute filters. Setting any field implicitly requires the person to have a current employer.

Show child attributes

investor · object

Filters on the investor entity (firm) and on the person's deal activity. Setting any field (including any nested deals.* field) implicitly requires the person to be an investor.

Show child attributes

page · integer · default: 0

Page number (0-based)

Required range: x >= 0

page_size · integer · default: 10

Number of results per page (max 500)

Required range: 1 <= x <= 500

sort_by · enum<string> · default: most_recent_deal_date

Sort order. All values are universally accepted — non-applicable values (e.g. lead_deal_count when no investor filter is set) resolve to 0 / null via COALESCE and naturally sort to the bottom (DESC). Ignored when company.search_query or investor.deals.search_query is set (results are then ordered by semantic relevance).

Available options: most_recent_deal_date, total_raised, latest_deal_size, name, total_deal_count, deal_count_last_12_months, lead_deal_count, lead_deal_count_last_12_months, filtered_deal_count

Response

200

application/json

Successful search results

success · boolean · required

Example:

true

data · object · required

Show child attributes

meta · object · required

Show child attributes

message · string

Optional friendly message (e.g. "No people found matching your filters" when empty)