HomeGuidesAPI Reference
API Reference

Get DSCP time series statistics filtered by query parameters

Retrieves DSCP time series statistics for a single appliance, a group of appliances, or all appliances. Returns data as JSON with column definitions and data arrays, where each data point corresponds to a timestamp. When nePk is empty, uses groupPk to filter appliances. Supports CSV export and IP-based grouping.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
^\d+\.NE$

Network Element Primary Key - unique appliance identifier assigned by Orchestrator. Format: '.NE' (e.g., '0.NE', '10.NE'). When omitted, results are returned for all appliances.

int64
required
≥ 0

Unix timestamp in seconds since EPOCH indicating the start of the data time range. Must be less than endTime.

int64
required
≥ 0

Unix timestamp in seconds since EPOCH indicating the end of the data time range. Must be greater than startTime.

string
enum
required

Data aggregation interval determining the resolution of time series data points.

Allowed:
string

Internal group identifier to retrieve stats for all appliances within that group. Used when nePk is not provided.

string
enum
required

Traffic category filter to specify which type of traffic statistics to retrieve.

Allowed:
integer
required
0 to 63

DSCP value to filter statistics. Valid range: 0-63. DSCP is used for QoS classification in IP packets.

integer
≤ 10000
Defaults to 10000

Maximum number of stats records to retrieve. Default and maximum value is 10000.

string
enum

Output format for the response. When set to 'CSV', returns data as downloadable CSV file.

Allowed:
boolean
Defaults to false

When true, groups stats by IP address instead of internal appliance ID. Default is false.

integer
≥ 1

Retrieve stats for the last N minutes from current time. Overrides startTime and endTime when provided.

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

401

Unauthorized - Authentication required or invalid credentials

403

Forbidden - User lacks READ or READ_WRITE permission

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
application/vnd.ms-excel