---
title: "Get hardware trends for a Switch"
method: GET
path: "/network-monitoring/v1/switches/{serial-number}/hardware-trends"
tags: ["Switch"]
---

# Get hardware trends for a Switch

`GET /network-monitoring/v1/switches/{serial-number}/hardware-trends`

## Request

- Base URL: `https://sso.common.cloud.hpe.com`
- URL: `https://sso.common.cloud.hpe.com/network-monitoring/v1/switches/{serial-number}/hardware-trends`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://sso.common.cloud.hpe.com/as/token.oauth2`

This API provides hardware trend data for a given site based on a serial number or stack id. When a stack id or conductor serial is provided, the trends are aggregated across for each member of the stack. When a member serial is provided, the trends are aggregated for that specific member. By default, data is aggregated over the last three hours from the current timestamp. Available metrics include CPU utilization, memory utilization, PoE available, PoE consumption, and total power available.

## Path parameters

- `serial-number` string, const, required: The device serial number.

## Query parameters

- `site-id` string, const
- `filter` string, const

## Response `200`

Object containing hardware trends related to the switch.

- HardwareTrendsResponse: Response containing hardware trends related to the switch.
  - `id` string, required: identifier.
  - `type` string, required: Device type of monitoring.
  - `metric` string: Trends name.
  - `keys` string[]: Trends list.
  - `switchMetrics` SwitchMetrics[]: Samples for the trends.
    - `serialNumber` string: Serial of the switch.
    - `switchRole` string: Role of the switch.
    - `samples` Sample[]: Samples for the interface trends in the key list.
      - `data` number[]: Samples list.
      - `timestamp` number: Timestamp for the samples.
  - `units` string[]: Units for the trends in the keys list.

## Other responses

- `400`: Invalid input received.
- `401`: Unauthorized. Authentication credentials are required or invalid.
- `403`: Forbidden: Access is denied.
- `404`: Device with serial number not found.
- `429`: Too Many Requests. The user has sent too many requests in a given amount of time.
- `500`: Internal Server Error. An unexpected error occurred on the server.

---

[API](https://skmtc.dev/arubanetworks/apis/authorization.md) - [All operations](https://skmtc.dev/arubanetworks/apis/authorization/llms.txt) - [OpenAPI document](https://skmtc.dev/arubanetworks/apis/authorization/revisions/74c95058b11f?raw)