Skip to main content
POST
/
people
curl --request POST \
  --url https://www.tryfundable.ai/api/v1/people \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "person": {
    "roles": [
      "founder"
    ]
  },
  "company": {
    "industries": [
      "fintech"
    ],
    "ipo_status": [
      "private"
    ]
  },
  "page_size": 25
}
'
{
  "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,
        "is_ceo": true,
        "is_key_person": true,
        "is_current": true,
        "followers": 123,
        "connections": 123,
        "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": {
          "deal_count": 12,
          "lead_deal_count": 123,
          "lead_deal_count_last_12_months": 123,
          "recent_deal_count": 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>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.tryfundable.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

API key authentication using Bearer token format. Format: Authorization: Bearer vg_your_api_key_here

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

​
person
object

Person attribute filters

​
company
object

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

​
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.

​
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,
followers,
connections,
name,
total_deal_count,
recent_deal_count,
lead_deal_count,
lead_deal_count_last_12_months,
filtered_deal_count

Response

Successful search results

​
success
boolean
required
Example:

true

​
data
object
required
​
meta
object
required
​
message
string

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