---
title: "Get data by device"
method: POST
path: "/bandwidth/device/{deviceId}"
tags: ["Bandwidth"]
---

# Get data by device

`POST /bandwidth/device/{deviceId}`

## Headers

- `X-Fields` string, mask

## Response `200`

Device Bandwidth Graph retrieved.

- Bandwidth[]
  - `bandwidthData` array[] — Returns an array where each item contains a dictionary of data and an identifier for each requested interface. The data itself is an array of arrays where each item is the measurementat the requested `step` and the index of each integer value corresponds with the legend returned in the `metadata`.
    - number[]
  - `interface` string — The interface(s) displayed in the image.
  - `metadata` object — Returns metadata about the query including the 95th percentile values of the returned data, legend for returned data arrays, and query args passed to the query.
  - `switchId` string — The unique ID of the switch where bandwidth data is measured.

## Other responses

- `400` — Unable to retrieve Bandwidth Graph for this Device.
- `403` — You have not been granted permission to complete this action. Please contact your account manager to grant the proper permission.

---

[API](https://skmtc.net/hivelocity/apis/hivelocity-api.md) · [All operations](https://skmtc.net/hivelocity/apis/hivelocity-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hivelocity/hivelocity-api/revisions/ee6b717b5015/schema)