curl --request POST \
--url https://www.tryfundable.ai/api/v1/people \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"page_size": 5
}'{
"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>"
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "<string>",
"details": {
"errors": [
{
"field": "<string>",
"value": "<string>",
"message": "<string>",
"code": "<string>",
"validOptions": [
"<string>"
]
}
]
}
}
}{
"success": false,
"error": {
"code": "AUTH_ERROR",
"message": "<string>",
"details": {
"help": "<string>"
}
}
}{
"error": {
"code": "INSUFFICIENT_CREDITS",
"message": "<string>",
"details": {
"credits_needed": 123,
"monthly_credits_remaining": 123,
"purchased_credits_remaining": 123,
"help": "<string>"
}
},
"success": false
}{
"success": false,
"error": {
"code": "UNKNOWN_PARAMETER",
"message": "<string>",
"details": {
"unknownParameters": [
"<string>"
],
"allowedParameters": [
"<string>"
]
}
}
}{
"error": {
"code": "RATE_LIMIT_EXCEEDED",
"message": "Rate limit exceeded. Maximum 200 requests per minute.",
"details": {
"limit": 200,
"window": "60 seconds",
"help": "<string>"
}
},
"success": false
}{
"success": false,
"error": {
"code": "INTERNAL_SERVER_ERROR",
"message": "<string>"
}
}{
"error": {
"code": "TIMEOUT",
"message": "The semantic search operation timed out. Please try a simpler query.",
"details": {
"failed_block": "company",
"help": "Try a simpler query or fewer filters"
}
},
"success": false
}People
People Search API
Retrieve people with advanced filtering, pagination, sorting, and optional AI-powered semantic search.
POST
/
people
curl --request POST \
--url https://www.tryfundable.ai/api/v1/people \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"page_size": 5
}'{
"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>"
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "<string>",
"details": {
"errors": [
{
"field": "<string>",
"value": "<string>",
"message": "<string>",
"code": "<string>",
"validOptions": [
"<string>"
]
}
]
}
}
}{
"success": false,
"error": {
"code": "AUTH_ERROR",
"message": "<string>",
"details": {
"help": "<string>"
}
}
}{
"error": {
"code": "INSUFFICIENT_CREDITS",
"message": "<string>",
"details": {
"credits_needed": 123,
"monthly_credits_remaining": 123,
"purchased_credits_remaining": 123,
"help": "<string>"
}
},
"success": false
}{
"success": false,
"error": {
"code": "UNKNOWN_PARAMETER",
"message": "<string>",
"details": {
"unknownParameters": [
"<string>"
],
"allowedParameters": [
"<string>"
]
}
}
}{
"error": {
"code": "RATE_LIMIT_EXCEEDED",
"message": "Rate limit exceeded. Maximum 200 requests per minute.",
"details": {
"limit": 200,
"window": "60 seconds",
"help": "<string>"
}
},
"success": false
}{
"success": false,
"error": {
"code": "INTERNAL_SERVER_ERROR",
"message": "<string>"
}
}{
"error": {
"code": "TIMEOUT",
"message": "The semantic search operation timed out. Please try a simpler query.",
"details": {
"failed_block": "company",
"help": "Try a simpler query or fewer filters"
}
},
"success": false
}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.Body
application/json
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"
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 Last modified on August 26, 2026

