Skip to main content
Retrieve your company watchlists with detailed information about tracked companies.

​
Query Parameters

​
id
string
Watchlist ID. If omitted, returns all company watchlists for your team.
curl -X GET \
  "https://api.outx.ai/api-company-watchlist" \
  -H "x-api-key: YOUR_API_KEY"

{
  "watchlists": [
    {
      "id": "880e8400-e29b-41d4-a716-446655440000",
      "name": "FAANG Companies",
      "slug": "faang-companies-880e8400",
      "type": "company",
      "createdAt": "2024-01-15T10:30:00Z"
    }
  ],
  "count": 1
}

​
Response Fields

​
watchlists
array
Array of watchlist objects (when fetching all)
​
count
number
Total number of watchlists (when fetching all)
​
id
string
Unique identifier for the watchlist
​
name
string
Watchlist name
​
slug
string
URL-friendly slug
​
type
string
Always “company” for company watchlists
​
companies_count
number
Number of tracked companies

​
Error Responses

Status CodeError MessageDescription
401UnauthorizedInvalid or missing API key
403Access deniedTrying to access watchlist from another team
404Watchlist not foundWatchlist ID doesn’t exist