Skip to main content
GET
/
lists
/
companies
Get all company lists
curl --request GET \
  --url https://app.tryspecter.com/api/v1/lists/companies \
  --header 'X-API-Key: <api-key>'
[
  {
    "id": "b73c8bed-3b92-48f9-a879-40ee114dca03",
    "name": "Favourites",
    "created_at": "2024-11-14T10:36:12.625Z",
    "updated_at": "2024-11-14T10:36:12.625Z",
    "is_global": false,
    "company_count": 10,
    "shared_with": [
      "user_2PFJ2V8IR837k6TPguVCIFhNsWA"
    ]
  }
]

Authorizations

​
X-API-Key
string
header
required

Response

The companies lists

​
id
string

List Id

Example:

"b73c8bed-3b92-48f9-a879-40ee114dca03"

​
name
string

Name of the list

Example:

"Favourites"

​
created_at
string<date-time>

Date list was created

Example:

"2024-11-14T10:36:12.625Z"

​
updated_at
string<date-time>

Date the list was last updated

Example:

"2024-11-14T10:36:12.625Z"

​
is_global
boolean

This flags lists recommended by Specter for all users

Example:

false

​
company_count
number

The number of companies in this list

Example:

10

​
shared_with
string[]

The user ids of the users this search is shared with

User Id