Get all investor lists

Returns the investor lists reachable from your API key: lists created via the API, lists with “Share to API” turned on, and global lists curated by Specter.

Free. This call does not consume credits.

What you need

At least one investor list reachable from your API key. Create one in the Specter app (then share it with the API from the list’s three-dot menu (⋯) by turning on “Share to API”), or via the API with Create investor list (lists created via the API are shared automatically). Global lists curated by Specter are always reachable.

Behaviour

• Each list object includes the number of investors in the list.
• Lists shared only within your team are not returned.
• To retrieve the investor IDs in a list, call Get investor list with that list’s ID.

What you do next

• Open a list’s investors. Get the investor IDs via Get investor list, or full profiles via Get investor list results.
• Build a new list. Create one with Create investor list.

GET /lists/investors

Get all investor lists

cURL

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

import requests

url = "https://app.tryspecter.com/api/v1/lists/investors"

headers = {"X-API-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

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

fetch('https://app.tryspecter.com/api/v1/lists/investors', 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",
  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"

	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))

}

HttpResponse<String> response = Unirest.get("https://app.tryspecter.com/api/v1/lists/investors")
  .header("X-API-Key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

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

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

200

[
  {
    "id": "dae1aa2c-abfb-41ae-b226-9e6db1e62694",
    "name": "PE Firms + Search Funds",
    "created_at": "2025-02-13T11:47:39.519590Z",
    "updated_at": "2025-02-13T11:47:39.519590Z",
    "investor_count": 63
  }
]

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

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

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

Authorizations

X-API-Key · string · header · required

Response

200

application/json

The investor lists

id · string<uuid> · required

List Id

Example:

"dae1aa2c-abfb-41ae-b226-9e6db1e62694"

name · string · required

Name of the list

Example:

"PE Firms + Search Funds"

created_at · string<date-time>

Date (YYYY:MM:DD) the list was created.

Example:

"2025-02-13T11:47:39.519590Z"

updated_at · string<date-time>

Date (YYYY:MM:DD) the list was last updated.

Example:

"2025-02-13T11:47:39.519590Z"

investor_count · integer

The number of investors in this list

Example:

63