Get watchlist statistics
curl --request GET \
--url https://api-prod.heliyos.ai/v1/platform/watchlist/statistics \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api-prod.heliyos.ai/v1/platform/watchlist/statistics', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api-prod.heliyos.ai/v1/platform/watchlist/statistics"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"meta": {
"message": "Watchlist statistics retrieved successfully"
},
"data": {
"tasks": {
"total": 48,
"completed": 31
},
"totalActions": 126,
"totalMeetings": 19,
"totalDeals": 7,
"accountStatus": {
"customer": 5,
"prospect": 9,
"unknown": 2
},
"engagementStatus": {
"active": 8,
"cooling": 3,
"unknown": 5
}
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}Watchlist
Get watchlist statistics
Returns counts of the work done on watched companies: linked tasks (and how many are completed), Autonomous Updates runs, meetings and deals, plus how many watched companies have each account status and engagement status. When no company is watched, every count is 0 and both status maps are empty.
To list the watched companies themselves, list your companies object’s records filtered on
isAgentAssigned. Watchers in use and your plan’s Watchers limit are on GET /v1/platform/organization
(watchersInUse, watchersLimit).
GET
/
v1
/
platform
/
watchlist
/
statistics
Get watchlist statistics
curl --request GET \
--url https://api-prod.heliyos.ai/v1/platform/watchlist/statistics \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api-prod.heliyos.ai/v1/platform/watchlist/statistics', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api-prod.heliyos.ai/v1/platform/watchlist/statistics"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"meta": {
"message": "Watchlist statistics retrieved successfully"
},
"data": {
"tasks": {
"total": 48,
"completed": 31
},
"totalActions": 126,
"totalMeetings": 19,
"totalDeals": 7,
"accountStatus": {
"customer": 5,
"prospect": 9,
"unknown": 2
},
"engagementStatus": {
"active": 8,
"cooling": 3,
"unknown": 5
}
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}In the Heliyos MCP server:
heliyos_watchlist_get.Authorizations
A workspace API key, sent as Authorization: Bearer heliyos_.... Create one in Heliyos under Settings → API keys. A key acts as a workspace admin in the one workspace it was created in.
Was this page helpful?

