Read iNSight metric series

GET

/insight/{label}

Last modified:2026-10-07 23:39:41

OperationId:ReadInsightSeries

Returns a time series for one iNSight metric, such as active calls or registered devices, for a window that ends now. Requires Super User, Super User Read Only, or Reseller scope.

A Super User reads the whole platform. A Reseller always reads its own territory, and only the labels with a reseller form: core_activecalls, core_domains, core_subscribers, and core_registered. Any other label returns 403 for a Reseller, except the nodeping_ health-check labels. A Super User Read Only token must name a reseller.

Set the window with range, or with start and end as Unix timestamps. step sets the interval between points. Times in the response are Unix timestamps in seconds, not RFC 3339. A window with no data returns 404.

The alert labels active_alerts, alert_groups, alert_silences, ruler_alerts, and ruler_rules need Super User or Super User Read Only scope, ignore the window parameters, and answer an alert envelope instead of a series. See GET /insight/active_alerts. ruler_rules also takes type, rule_name, rule_group, and file.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Query Params

Responses

🟢200OK

application/json

The series, as an array of points. Only the first point carries debug-parameters.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

🔴500Internal Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff 'https://awqacore01.crexendocloud.com/ns-api/v2/insight/core_activecalls?range=last_24_hours&aggregated=aggregated&start=1788269400&end=1788273000&step=1m&reseller=example-reseller&transport=udp&query=sum(max_over_time(core_activecalls{app%3D%27core%27}[1m]))' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Platform series

core_activecalls with range=last_hour, shortened.

[
    {
        "value": 41,
        "ts": 1788272820,
        "debug-parameters": {
            "query": "sum(max_over_time(core_activecalls{app='core'}[1m]))",
            "start": 1788269460,
            "end": 1788273000,
            "step": "1m"
        }
    },
    {
        "value": 44,
        "ts": 1788272880
    },
    {
        "value": 43,
        "ts": 1788272940
    },
    {
        "value": 42,
        "ts": 1788273000
    }
]

Modified at 2026-10-07 23:39:41

List active iNSight alerts

List conferences in domain