curl --request GET \
--url https://api-prod.heliyos.ai/v1/platform/signals \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api-prod.heliyos.ai/v1/platform/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/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": "6735a9d1e2f3a4b5c6d7e8f9",
"organizationId": "66a0f1e2d3c4b5a697887766",
"scoutSchemaId": "6732d4e5f6a7b8c9d0e1f2a5",
"baseSchemaObjectId": "66f1a8c3e4b0a1b2c3d4e5f6",
"category": "Growth & Expansion",
"scout_name": "Funding, M&A, or financial news",
"scope": "watchlist",
"company_name": "Northwind Traders",
"website": "https://northwind.example.com",
"summary": "Northwind Traders raised a 40 million dollar Series C to expand into Southeast Asia.",
"citations": [
"https://news.example.com/northwind-series-c"
],
"relevance_score": 86,
"confidence_score": 0.86,
"source": "scouts",
"detected_date": "2026-11-03T06:00:00.000Z",
"status": "new",
"metadata": {
"created": {
"at": "2026-11-03T06:02:00.000Z",
"by": "webhook"
},
"updated": {
"at": "2026-11-03T06:02:00.000Z",
"by": "webhook"
}
}
}
]
}{
"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 signals
Returns the workspace’s signals, most recently detected first. Filter by company, company Scout and status.
By default the list pages with a cursor: pass limit, then send meta.pagination.next_cursor back as
cursor for the next page. If the signal a cursor points at was deleted, the call answers 400; list
again from the first page. Sending offset or page (without cursor) switches to offset paging,
where meta.pagination is { limit, offset, total, hasMore }. See Pagination.
scoutId here is a company Scout id. To list everything one workspace Scout found across its companies,
use GET /v1/platform/global-scouts/{id}/signals.
curl --request GET \
--url https://api-prod.heliyos.ai/v1/platform/signals \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api-prod.heliyos.ai/v1/platform/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/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": "6735a9d1e2f3a4b5c6d7e8f9",
"organizationId": "66a0f1e2d3c4b5a697887766",
"scoutSchemaId": "6732d4e5f6a7b8c9d0e1f2a5",
"baseSchemaObjectId": "66f1a8c3e4b0a1b2c3d4e5f6",
"category": "Growth & Expansion",
"scout_name": "Funding, M&A, or financial news",
"scope": "watchlist",
"company_name": "Northwind Traders",
"website": "https://northwind.example.com",
"summary": "Northwind Traders raised a 40 million dollar Series C to expand into Southeast Asia.",
"citations": [
"https://news.example.com/northwind-series-c"
],
"relevance_score": 86,
"confidence_score": 0.86,
"source": "scouts",
"detected_date": "2026-11-03T06:00:00.000Z",
"status": "new",
"metadata": {
"created": {
"at": "2026-11-03T06:02:00.000Z",
"by": "webhook"
},
"updated": {
"at": "2026-11-03T06:02:00.000Z",
"by": "webhook"
}
}
}
]
}{
"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_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.
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. Skips (page - 1) * limit signals. 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 found by this company Scout (an id from GET /v1/platform/companies/{id}/scouts). An unknown id returns an empty list.
^[0-9a-fA-F]{24}$Only signals about this company record. An unknown id returns an empty list.
^[0-9a-fA-F]{24}$Was this page helpful?

