curl --request GET \
--url https://api-prod.heliyos.ai/v1/platform/global-scouts/{id}/signals \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api-prod.heliyos.ai/v1/platform/global-scouts/{id}/signals', 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/global-scouts/{id}/signals"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"meta": {
"message": "Signals retrieved successfully",
"pagination": {
"limit": 20,
"next_cursor": "NjZmMWE4YzNlNGIwYTFiMmMzZDRlNWY2"
}
},
"data": [
{
"_id": "6735a9d1e2f3a4b5c6d7e8fa",
"organizationId": "66a0f1e2d3c4b5a697887766",
"scoutSchemaId": "6732d4e5f6a7b8c9d0e1f2a3",
"baseSchemaObjectId": "66f1a8c3e4b0a1b2c3d4e5f6",
"category": "Hiring",
"scout_name": "Hiring for data roles",
"scope": "watchlist",
"summary": "Northwind Traders posted three senior data engineer roles in Lisbon.",
"citations": [
"https://careers.northwind.example.com/jobs/data-engineer"
],
"relevance_score": 72,
"source": "scouts",
"detected_date": "2026-11-03T06:00:00.000Z",
"status": "new",
"companyName": "Northwind Traders"
}
]
}{
"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>"
}
}List workspace Scout signals
Returns the signals one workspace Scout found across every company it runs on, most recently detected
first, each with companyName. Signals of company Scouts that were deleted (for example when a company
was unwatched or the Scout was edited to drop it) are not included.
Paging works as in List signals (GET /v1/platform/signals): cursor by default, offset paging when you
send offset or page.
curl --request GET \
--url https://api-prod.heliyos.ai/v1/platform/global-scouts/{id}/signals \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api-prod.heliyos.ai/v1/platform/global-scouts/{id}/signals', 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/global-scouts/{id}/signals"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"meta": {
"message": "Signals retrieved successfully",
"pagination": {
"limit": 20,
"next_cursor": "NjZmMWE4YzNlNGIwYTFiMmMzZDRlNWY2"
}
},
"data": [
{
"_id": "6735a9d1e2f3a4b5c6d7e8fa",
"organizationId": "66a0f1e2d3c4b5a697887766",
"scoutSchemaId": "6732d4e5f6a7b8c9d0e1f2a3",
"baseSchemaObjectId": "66f1a8c3e4b0a1b2c3d4e5f6",
"category": "Hiring",
"scout_name": "Hiring for data roles",
"scope": "watchlist",
"summary": "Northwind Traders posted three senior data engineer roles in Lisbon.",
"citations": [
"https://careers.northwind.example.com/jobs/data-engineer"
],
"relevance_score": 72,
"source": "scouts",
"detected_date": "2026-11-03T06:00:00.000Z",
"status": "new",
"companyName": "Northwind Traders"
}
]
}{
"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>"
}
}heliyos_scouts_get, heliyos_signals_list.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.
Path Parameters
The workspace Scout's id.
^[0-9a-fA-F]{24}$Query Parameters
Signals per page, 1 to 100. Defaults to 20.
1 <= x <= 100The next_cursor from the previous page. Takes precedence over offset and page.
next_cursor from the previous page; only valid with the default sort.
200A page number, starting at 1, for offset paging. Ignored when offset is sent.
x >= 1The number of signals to skip, for offset paging.
x >= 0Only signals in this status: new (unread), read or archived.
new, read, archived Only signals detected at or after this ISO 8601 date-time.
Only signals detected at or before this ISO 8601 date-time.
Only signals about this company record. A company the Scout does not run on returns an empty list.
^[0-9a-fA-F]{24}$Was this page helpful?

