---
title: "Query Data from iNSight"
method: GET
path: "/insight/{label}"
tags: ["iNSight"]
---

# Query Data from iNSight

`GET /insight/{label}`

## Request

- Base URL: `https://ns-api.com/ns-api/v2`
- URL: `https://ns-api.com/ns-api/v2/insight/{label}`
- Auth: HTTP bearer

## Path parameters

- `label` 'core_activecalls' | 'core_domains' | 'node_load5' | 'node_load5_max' | 'alerts' | 'core_subscribers' | 'core_registered' | 'nsnode_sockets' | 'system_packet_dispatched_total' | 'sip_invite_received_total' | 'sbus_system_queued' | 'custom', required

## Query parameters

- `range` 'last_hour' | 'last_6_hours' | 'last_12_hours' | 'last_24_hours' | 'last_7_days' | 'last_28_days'
- `aggregated` 'aggregated' | 'server'
- `start` number: This is the start value when using pagination. 0 is the default and the minimum value. For example the default of 0 paired with the default limit of 100 would return the first 100 objects in the data request. A start of 100 and a default limit of 100 would give you the second 100 results in the response.
- `end` integer
- `step` string
- `query` string

## Response `200`

- InsightValue[]
  - `server` string: Optional Server is aggregated by server
  - `value` number, required: The value
  - `ts` integer, required: The timestamp for the value. Modulo the expected interval/step
  - `debug-parameters` object
    - `query` string, required: The is the query that is sent to insight
    - `start` integer, required: The start timestamp
    - `end` integer, required: The end timestamp
    - `step` string, required: The interval for which insight will split the data up.

## Other responses

- `400`
- `401`
- `404`

## Changes

- **2026-11-03** `bce16087d479`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ns-api/apis/netsapiens-api-v2/changes/insight/:label/get.md)

---

[API](https://skmtc.dev/ns-api/apis/netsapiens-api-v2.md) - [All operations](https://skmtc.dev/ns-api/apis/netsapiens-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/ns-api/apis/netsapiens-api-v2/revisions/bce16087d479?raw)