Get investor list results

curl --request GET \
  --url https://app.tryspecter.com/api/v1/lists/investors/{listId}/results \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://app.tryspecter.com/api/v1/lists/investors/{listId}/results', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.tryspecter.com/api/v1/lists/investors/{listId}/results",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.tryspecter.com/api/v1/lists/investors/{listId}/results"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.tryspecter.com/api/v1/lists/investors/{listId}/results")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

[
  {
    "investor_id": "inv_84f563826c689ceb42aff52a",
    "investor_name": "Sequoia Capital",
    "strategic_signal_ids": [
      "9d7dea32-d8f2-46ab-a794-562dd5775877",
      "e4f05086-8862-4f05-b871-b7485d84e996",
      "e63e5f0b-2d02-491d-9f7f-6f4cb7c141e1",
      "ce1dc8a4-4a53-49e9-ad79-7e741d8f4eca",
      "2cb275ef-463f-4102-85af-4674e72502f7",
      "41da8f9f-947f-4c37-a054-cc056d8fe8aa",
      "a59913fa-4fe3-4426-9e02-e661e50d659c",
      "1b5d35c7-b553-4589-a7e0-8f2bfebdce0c",
      "3512c9d6-dc5d-448f-8aa3-83688f90c6f1",
      "ce0fb6bb-04de-4d1c-93ea-6da5c724bf6c"
    ],
    "person_id": "5e3b9281137e998b5aea67f4",
    "company_id": "5e3bbc2600c8f4c966983640",
    "investor_rank": 12,
    "company_size": "201-500",
    "operating_status": "active",
    "domain": "sequoiacap.com",
    "hq_location": "Menlo Park, California, United States, North America",
    "founded_year": 1972,
    "investor_types": [
      "venture_capital"
    ],
    "linkedin_url": "linkedin.com/company/sequoia",
    "twitter_url": "x.com/sequoia",
    "description": "Sequoia Capital is a venture capital firm founded by Don Valentine in 1972, with a mission to help daring founders build legendary companies from idea to IPO and beyond. They invest in a select few outliers each year, providing hands-on support throughout the company's lifecycle. Sequoia's expertise is drawn from 50 years of partnering with iconic founders. Their backing has resulted in companies accounting for over 25% of NASDAQ's total value. A significant portion of their investments is made on behalf of nonprofits and schools, directing returns to these organizations.",
    "number_of_exits": 453,
    "number_of_lead_investments": 884,
    "number_of_investments": 2392,
    "number_of_funds": 36,
    "investment_stage": [
      "Angel",
      "Convertible Note",
      "Corporate Round",
      "Debt Financing",
      "Equity Crowdfunding",
      "Grant",
      "Initial Coin Offering",
      "Post Ipo Debt",
      "Post Ipo Equity",
      "Pre Seed"
    ],
    "industry_target": [
      "Administrative Services",
      "Advertising",
      "Agriculture and Farming",
      "Biotechnology",
      "Blockchain and Crypto",
      "Clothing and Apparel",
      "Commerce and Shopping",
      "Community and Lifestyle",
      "Construction",
      "Consumer Products"
    ],
    "specter_industry_target": [
      "Accommodation Services",
      "Accounting",
      "Administrative and Support Services",
      "Advertising Services",
      "Agricultural Technology",
      "Airlines and Aviation",
      "Appliances, Electrical, and Electronics Manufacturing",
      "Architecture and Planning",
      "Artists and Writers",
      "Automation Machinery Manufacturing"
    ],
    "specter_tech_verticals_target": [
      "AI & Machine Learning",
      "AI Agents and Process Copilots",
      "AI Evaluation and Benchmarking",
      "AI Media and Virtual Creators",
      "AI Platforms, SDKs and APIs",
      "AI Safety and Governance",
      "AI Sales Copilots, Conversation Intelligence, and Assistants",
      "AI Security and Model Protection",
      "AI Tutors and Adaptive Learning",
      "AI and Analytics for Supply Chain Optimization"
    ],
    "fund_details": [
      {
        "name": "Sequoia Capital Venture Fund II",
        "announced_on": "2025-10-27",
        "raised_amount_usd": "750000000"
      }
    ],
    "portfolio_companies": [
      "5e3a8f1b040ca7b0c6f06a3c",
      "6495263511c3a8c65a7c742d",
      "67b7765cc3099373c3e3803a",
      "5e3b927f137e998b5aea5e93",
      "5e3b65e8ab6348f63cd9e5df",
      "60422e064ddab8d8bf2b6338",
      "5ed1cf8b4ae879e7872a002c",
      "5e3bc0f900c8f4c966a6ded6",
      "5e3a8f1b040ca7b0c6f07476",
      "5e3b9fe6137e998b5aee9c4b"
    ]
  }
]

{
  "errorCode": "INVALID_LIST_UUID",
  "message": "List id must be a valid UUID."
}

{
  "errorCode": "API_KEY_MISSING",
  "message": "No API Key was presented on the header X-API-KEY"
}

{
  "errorCode": "OUT_OF_CREDITS",
  "message": "<string>"
}

{
  "errorCode": "NOT_PERMITTED",
  "message": "You do not have permission to access this resource."
}

{
  "errorCode": "<string>",
  "message": "<string>"
}

{
  "errorCode": "<string>",
  "message": "<string>"
}

Investor Lists

Get investor list results

Returns the investors in a list with their current profile, activity, and targeting data.

Costs 1 credit per result returned.

What you need

A list ID (UUID) reachable from your API key.

Behaviour

listId must be a UUID, otherwise 400.
The list must be of product type investors; other product types return 400.
Page through with page and limit.
The list must be reachable from your API key.

What you do next

Open a single investor. Follow an investor_id to Get investor by ID.

GET

lists

investors

{listId}

results

Get investor list results

curl --request GET \
  --url https://app.tryspecter.com/api/v1/lists/investors/{listId}/results \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://app.tryspecter.com/api/v1/lists/investors/{listId}/results', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.tryspecter.com/api/v1/lists/investors/{listId}/results",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.tryspecter.com/api/v1/lists/investors/{listId}/results"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.tryspecter.com/api/v1/lists/investors/{listId}/results")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

[
  {
    "investor_id": "inv_84f563826c689ceb42aff52a",
    "investor_name": "Sequoia Capital",
    "strategic_signal_ids": [
      "9d7dea32-d8f2-46ab-a794-562dd5775877",
      "e4f05086-8862-4f05-b871-b7485d84e996",
      "e63e5f0b-2d02-491d-9f7f-6f4cb7c141e1",
      "ce1dc8a4-4a53-49e9-ad79-7e741d8f4eca",
      "2cb275ef-463f-4102-85af-4674e72502f7",
      "41da8f9f-947f-4c37-a054-cc056d8fe8aa",
      "a59913fa-4fe3-4426-9e02-e661e50d659c",
      "1b5d35c7-b553-4589-a7e0-8f2bfebdce0c",
      "3512c9d6-dc5d-448f-8aa3-83688f90c6f1",
      "ce0fb6bb-04de-4d1c-93ea-6da5c724bf6c"
    ],
    "person_id": "5e3b9281137e998b5aea67f4",
    "company_id": "5e3bbc2600c8f4c966983640",
    "investor_rank": 12,
    "company_size": "201-500",
    "operating_status": "active",
    "domain": "sequoiacap.com",
    "hq_location": "Menlo Park, California, United States, North America",
    "founded_year": 1972,
    "investor_types": [
      "venture_capital"
    ],
    "linkedin_url": "linkedin.com/company/sequoia",
    "twitter_url": "x.com/sequoia",
    "description": "Sequoia Capital is a venture capital firm founded by Don Valentine in 1972, with a mission to help daring founders build legendary companies from idea to IPO and beyond. They invest in a select few outliers each year, providing hands-on support throughout the company's lifecycle. Sequoia's expertise is drawn from 50 years of partnering with iconic founders. Their backing has resulted in companies accounting for over 25% of NASDAQ's total value. A significant portion of their investments is made on behalf of nonprofits and schools, directing returns to these organizations.",
    "number_of_exits": 453,
    "number_of_lead_investments": 884,
    "number_of_investments": 2392,
    "number_of_funds": 36,
    "investment_stage": [
      "Angel",
      "Convertible Note",
      "Corporate Round",
      "Debt Financing",
      "Equity Crowdfunding",
      "Grant",
      "Initial Coin Offering",
      "Post Ipo Debt",
      "Post Ipo Equity",
      "Pre Seed"
    ],
    "industry_target": [
      "Administrative Services",
      "Advertising",
      "Agriculture and Farming",
      "Biotechnology",
      "Blockchain and Crypto",
      "Clothing and Apparel",
      "Commerce and Shopping",
      "Community and Lifestyle",
      "Construction",
      "Consumer Products"
    ],
    "specter_industry_target": [
      "Accommodation Services",
      "Accounting",
      "Administrative and Support Services",
      "Advertising Services",
      "Agricultural Technology",
      "Airlines and Aviation",
      "Appliances, Electrical, and Electronics Manufacturing",
      "Architecture and Planning",
      "Artists and Writers",
      "Automation Machinery Manufacturing"
    ],
    "specter_tech_verticals_target": [
      "AI & Machine Learning",
      "AI Agents and Process Copilots",
      "AI Evaluation and Benchmarking",
      "AI Media and Virtual Creators",
      "AI Platforms, SDKs and APIs",
      "AI Safety and Governance",
      "AI Sales Copilots, Conversation Intelligence, and Assistants",
      "AI Security and Model Protection",
      "AI Tutors and Adaptive Learning",
      "AI and Analytics for Supply Chain Optimization"
    ],
    "fund_details": [
      {
        "name": "Sequoia Capital Venture Fund II",
        "announced_on": "2025-10-27",
        "raised_amount_usd": "750000000"
      }
    ],
    "portfolio_companies": [
      "5e3a8f1b040ca7b0c6f06a3c",
      "6495263511c3a8c65a7c742d",
      "67b7765cc3099373c3e3803a",
      "5e3b927f137e998b5aea5e93",
      "5e3b65e8ab6348f63cd9e5df",
      "60422e064ddab8d8bf2b6338",
      "5ed1cf8b4ae879e7872a002c",
      "5e3bc0f900c8f4c966a6ded6",
      "5e3a8f1b040ca7b0c6f07476",
      "5e3b9fe6137e998b5aee9c4b"
    ]
  }
]

{
  "errorCode": "INVALID_LIST_UUID",
  "message": "List id must be a valid UUID."
}

{
  "errorCode": "API_KEY_MISSING",
  "message": "No API Key was presented on the header X-API-KEY"
}

{
  "errorCode": "OUT_OF_CREDITS",
  "message": "<string>"
}

{
  "errorCode": "NOT_PERMITTED",
  "message": "You do not have permission to access this resource."
}

{
  "errorCode": "<string>",
  "message": "<string>"
}

{
  "errorCode": "<string>",
  "message": "<string>"
}

Authorizations

X-API-Key

string

header

required

Path Parameters

listId

string<uuid>

required

The ID of the list being requested.

Query Parameters

limit

number

The number of results to return, default is 50.

page

number

The page number of results to return, base 0, default is 0.

Response

The investors matching the lookup.

investor_id

string

required

The Specter ID for this investor, can be used in other endpoints.

Example:

"inv_84f563826c689ceb42aff52a"

investor_name

string

required

The legal or brand name of the investor or investment firm.

Example:

"Sequoia Capital"

strategic_signal_ids

string<uuid>[]

All Interest Signals IDs associated with this investor. Empty when none are active.

Example:

[
  "9d7dea32-d8f2-46ab-a794-562dd5775877",
  "e4f05086-8862-4f05-b871-b7485d84e996",
  "e63e5f0b-2d02-491d-9f7f-6f4cb7c141e1",
  "ce1dc8a4-4a53-49e9-ad79-7e741d8f4eca",
  "2cb275ef-463f-4102-85af-4674e72502f7",
  "41da8f9f-947f-4c37-a054-cc056d8fe8aa",
  "a59913fa-4fe3-4426-9e02-e661e50d659c",
  "1b5d35c7-b553-4589-a7e0-8f2bfebdce0c",
  "3512c9d6-dc5d-448f-8aa3-83688f90c6f1",
  "ce0fb6bb-04de-4d1c-93ea-6da5c724bf6c"
]

person_id

string | null

The Specter person ID this investor is linked to, when the investor is an individual (e.g. an angel). null for firms.

Example:

"5e3b9281137e998b5aea67f4"

company_id

string | null

The Specter company ID of the company associated with this investor, when applicable (e.g. the firm behind a VC fund).

Example:

"5e3bbc2600c8f4c966983640"

investor_rank

integer | null

The Specter rank for this investor.

Example:

12

company_size

string | null

The size bracket of the investor's organization (employee count band).

Example:

"201-500"

operating_status

string | null

The operating status of the investor (e.g. active, closed).

Example:

"active"

domain

string | null

The investor's primary web domain.

Example:

"sequoiacap.com"

hq_location

string | null

The investor's headquarters location.

Example:

"Menlo Park, California, United States, North America"

founded_year

integer | null

The year the investor was founded.

Example:

1972

investor_types

string[]

The investor types this investor falls under, as lowercase snake_case (e.g. venture_capital, angel_group).

Example:

["venture_capital"]

linkedin_url

string | null

The investor's LinkedIn profile URL.

Example:

"linkedin.com/company/sequoia"

twitter_url

string | null

The investor's Twitter / X profile URL.

Example:

"x.com/sequoia"

description

string | null

Brief textual overview of the investor's activities, history, or focus.

Example:

"Sequoia Capital is a venture capital firm founded by Don Valentine in 1972, with a mission to help daring founders build legendary companies from idea to IPO and beyond. They invest in a select few outliers each year, providing hands-on support throughout the company's lifecycle. Sequoia's expertise is drawn from 50 years of partnering with iconic founders. Their backing has resulted in companies accounting for over 25% of NASDAQ's total value. A significant portion of their investments is made on behalf of nonprofits and schools, directing returns to these organizations."

number_of_exits

integer | null

Total number of portfolio company exits attributed to this investor.

Example:

453

number_of_lead_investments

integer | null

Total number of investments where the investor led the round.

Example:

884

number_of_investments

integer | null

Total number of investments made by the investor.

Example:

2392

number_of_funds

integer | null

Total number of separate funds managed or raised by the firm.

Example:

36

investment_stage

string[]

Typical funding round stages in which the investor participates (e.g., Seed, Series A).

Example:

[
  "Angel",
  "Convertible Note",
  "Corporate Round",
  "Debt Financing",
  "Equity Crowdfunding",
  "Grant",
  "Initial Coin Offering",
  "Post Ipo Debt",
  "Post Ipo Equity",
  "Pre Seed"
]

industry_target

string[]

Industries or verticals in which the investor typically specializes.

Example:

[
  "Administrative Services",
  "Advertising",
  "Agriculture and Farming",
  "Biotechnology",
  "Blockchain and Crypto",
  "Clothing and Apparel",
  "Commerce and Shopping",
  "Community and Lifestyle",
  "Construction",
  "Consumer Products"
]

specter_industry_target

string[]

Only top level. Classifies companies by their economic activity - the market they serve and the products or services they deliver. E.g. Construction, Utilities, Wholesale. There is one industry per company, with up to three levels.

Example:

[
  "Accommodation Services",
  "Accounting",
  "Administrative and Support Services",
  "Advertising Services",
  "Agricultural Technology",
  "Airlines and Aviation",
  "Appliances, Electrical, and Electronics Manufacturing",
  "Architecture and Planning",
  "Artists and Writers",
  "Automation Machinery Manufacturing"
]

specter_tech_verticals_target

string[]

Only top level. Classifies companies by the technology domain they operate in - the technical capability or space they're building around. E.g. AI & Machine Learning, Cybersecurity, FinTech. There can be up to 5 tech verticals per company, with 2 levels each.

Example:

[
  "AI & Machine Learning",
  "AI Agents and Process Copilots",
  "AI Evaluation and Benchmarking",
  "AI Media and Virtual Creators",
  "AI Platforms, SDKs and APIs",
  "AI Safety and Governance",
  "AI Sales Copilots, Conversation Intelligence, and Assistants",
  "AI Security and Model Protection",
  "AI Tutors and Adaptive Learning",
  "AI and Analytics for Supply Chain Optimization"
]

fund_details

InvestorFund · object[]

The named funds this investor has raised, with announce date and amount when available.

Show child attributes

portfolio_companies

string[]

Specter company IDs for portfolio companies of this investor.

Example:

[
  "5e3a8f1b040ca7b0c6f06a3c",
  "6495263511c3a8c65a7c742d",
  "67b7765cc3099373c3e3803a",
  "5e3b927f137e998b5aea5e93",
  "5e3b65e8ab6348f63cd9e5df",
  "60422e064ddab8d8bf2b6338",
  "5ed1cf8b4ae879e7872a002c",
  "5e3bc0f900c8f4c966a6ded6",
  "5e3a8f1b040ca7b0c6f07476",
  "5e3b9fe6137e998b5aee9c4b"
]

Delete investor list Get all people lists

Enrich

Search

Companies

People

Investors

Transactions

Signals

Lists

Saved Searches

Network

Account

Get investor list results

What you need

Behaviour

What you do next

Authorizations

Path Parameters

Query Parameters

Response