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

{
  "success": true,
  "data": {
    "investors": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>",
        "total_deal_count": 123,
        "lead_deal_count": 123,
        "deal_count_last_12_months": 123,
        "guru_permalink": "<string>",
        "lead_deal_count_last_12_months": 123,
        "most_recent_deal_date": "2023-11-07T05:31:56Z",
        "domain": "<string>",
        "website": "<string>",
        "linkedin": "<string>",
        "pitchbook": "<string>",
        "crunchbase": "<string>",
        "description": "<string>",
        "legal_name": "<string>",
        "num_employees": "101-250",
        "investment_stage": "Series A",
        "contact_email": "jsmith@example.com",
        "contact_phone": "<string>",
        "location": {
          "region": {
            "name": "North America",
            "permalink": "north-america"
          },
          "country": {
            "name": "United States",
            "permalink": "united-states"
          },
          "state": {
            "name": "California",
            "permalink": "california"
          },
          "city": {
            "name": "San Francisco",
            "permalink": "san-francisco-california"
          }
        },
        "top_industries": [
          {
            "name": "<string>",
            "permalink": "<string>",
            "count": 123
          }
        ],
        "top_locations": [
          {
            "name": "<string>",
            "full_name": "<string>",
            "permalink": "<string>",
            "type": "<string>",
            "count": 123
          }
        ],
        "top_round_types": [
          {
            "type": "<string>",
            "count": 123
          }
        ],
        "filtered_deal_count": 123,
        "filtered_lead_count": 123
      }
    ]
  },
  "meta": {
    "total_count": 142,
    "page": 0,
    "page_size": 25,
    "credits_used": 10,
    "credit_source": "monthly",
    "monthly_credits_remaining": 990,
    "purchased_credits_remaining": 500
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters",
    "details": {
      "errors": [
        {
          "field": "<string>",
          "value": "<string>",
          "message": "<string>",
          "code": "<string>",
          "validOptions": [
            "<string>"
          ]
        }
      ],
      "help": "<string>"
    }
  }
}

{
  "error": {
    "code": "AUTH_ERROR",
    "message": "API key not provided",
    "details": {
      "help": "Please provide your API key in the Authorization header",
      "format": "Bearer vg_your_api_key_here"
    }
  }
}

{
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "Not enough credits to complete this request. Visit https://www.tryfundable.ai/api-access to purchase more.",
    "details": {
      "credits_needed": 25,
      "monthly_credits_remaining": 0,
      "purchased_credits_remaining": 0,
      "help": "Purchase additional credits at https://www.tryfundable.ai/api-access or upgrade your plan."
    }
  },
  "success": false
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters",
    "details": {
      "errors": [
        {
          "field": "<string>",
          "value": "<string>",
          "message": "<string>",
          "code": "<string>",
          "validOptions": [
            "<string>"
          ]
        }
      ],
      "help": "<string>"
    }
  }
}

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Rate limit exceeded. Maximum 200 requests per minute.",
    "details": {
      "limit": 200,
      "window": "60 seconds",
      "help": "Please reduce your request frequency and try again."
    }
  },
  "success": false
}

{
  "error": {
    "code": "INTERNAL_SERVER_ERROR",
    "message": "An unexpected error occurred",
    "details": "<string>"
  }
}

Investors

List Investors

Retrieve a paginated list of investors with optional filtering.

Request Body Structure

Send a JSON body with up to 3 filter sections plus pagination/sort at the top level:

identifiers - Look up specific investors by UUID, domain, LinkedIn, or Crunchbase
investor - Filter by investor entity attributes (location, employee count)
company_investments - Filter by portfolio (industries, deal characteristics, etc.). Supports semantic search via search_query + min_relevance.

When company_investments filters are active, each investor in the response includes filtered_deal_count and filtered_lead_count.

POST

investors

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

{
  "success": true,
  "data": {
    "investors": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>",
        "total_deal_count": 123,
        "lead_deal_count": 123,
        "deal_count_last_12_months": 123,
        "guru_permalink": "<string>",
        "lead_deal_count_last_12_months": 123,
        "most_recent_deal_date": "2023-11-07T05:31:56Z",
        "domain": "<string>",
        "website": "<string>",
        "linkedin": "<string>",
        "pitchbook": "<string>",
        "crunchbase": "<string>",
        "description": "<string>",
        "legal_name": "<string>",
        "num_employees": "101-250",
        "investment_stage": "Series A",
        "contact_email": "jsmith@example.com",
        "contact_phone": "<string>",
        "location": {
          "region": {
            "name": "North America",
            "permalink": "north-america"
          },
          "country": {
            "name": "United States",
            "permalink": "united-states"
          },
          "state": {
            "name": "California",
            "permalink": "california"
          },
          "city": {
            "name": "San Francisco",
            "permalink": "san-francisco-california"
          }
        },
        "top_industries": [
          {
            "name": "<string>",
            "permalink": "<string>",
            "count": 123
          }
        ],
        "top_locations": [
          {
            "name": "<string>",
            "full_name": "<string>",
            "permalink": "<string>",
            "type": "<string>",
            "count": 123
          }
        ],
        "top_round_types": [
          {
            "type": "<string>",
            "count": 123
          }
        ],
        "filtered_deal_count": 123,
        "filtered_lead_count": 123
      }
    ]
  },
  "meta": {
    "total_count": 142,
    "page": 0,
    "page_size": 25,
    "credits_used": 10,
    "credit_source": "monthly",
    "monthly_credits_remaining": 990,
    "purchased_credits_remaining": 500
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters",
    "details": {
      "errors": [
        {
          "field": "<string>",
          "value": "<string>",
          "message": "<string>",
          "code": "<string>",
          "validOptions": [
            "<string>"
          ]
        }
      ],
      "help": "<string>"
    }
  }
}

{
  "error": {
    "code": "AUTH_ERROR",
    "message": "API key not provided",
    "details": {
      "help": "Please provide your API key in the Authorization header",
      "format": "Bearer vg_your_api_key_here"
    }
  }
}

{
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "Not enough credits to complete this request. Visit https://www.tryfundable.ai/api-access to purchase more.",
    "details": {
      "credits_needed": 25,
      "monthly_credits_remaining": 0,
      "purchased_credits_remaining": 0,
      "help": "Purchase additional credits at https://www.tryfundable.ai/api-access or upgrade your plan."
    }
  },
  "success": false
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters",
    "details": {
      "errors": [
        {
          "field": "<string>",
          "value": "<string>",
          "message": "<string>",
          "code": "<string>",
          "validOptions": [
            "<string>"
          ]
        }
      ],
      "help": "<string>"
    }
  }
}

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Rate limit exceeded. Maximum 200 requests per minute.",
    "details": {
      "limit": 200,
      "window": "60 seconds",
      "help": "Please reduce your request frequency and try again."
    }
  },
  "success": false
}

{
  "error": {
    "code": "INTERNAL_SERVER_ERROR",
    "message": "An unexpected error occurred",
    "details": "<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

identifiers

object

Investor lookup filters (OR'd together)

Show child attributes

investor

object

Investor entity-level filters

Show child attributes

company_investments

object

Portfolio filters (filter by companies the investor has invested in)

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

Sort order for results.

most_recent_deal — Date of most recent investment (newest first)
recent_deals — Deals in last 12 months (highest first)
deals_led_ltm — Lead deals in last 12 months (highest first)
total_deals — All-time deal count (highest first)
matching_deals — Deals matching portfolio filters (highest first)

Available options:

most_recent_deal,

recent_deals,

deals_led_ltm,

total_deals,

matching_deals

Response

Successful response with paginated investor list

success

boolean

required

Example:

true

data

object

required

Show child attributes

Overview

Deals

Companies

Investors

People

Filters

Alerts

List Investors

Request Body Structure

Authorizations

Body

Response