---
title: "Get Wireless Client Mobility Details"
method: GET
path: "/network-monitoring/v1/clients/{mac-address}/mobility-trail"
tags: ["Clients"]
---

# Get Wireless Client Mobility Details

`GET /network-monitoring/v1/clients/{mac-address}/mobility-trail`

## Request

- Base URL: `https://sso.common.cloud.hpe.com`
- URL: `https://sso.common.cloud.hpe.com/network-monitoring/v1/clients/{mac-address}/mobility-trail`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://sso.common.cloud.hpe.com/as/token.oauth2`

This API endpoint retrieves wireless client mobility details.

## Path parameters

- `mac-address` string, const, required

## Query parameters

- `site-id` string, const
- `site-name` string, const
- `start-at` string
- `end-at` string
- `filter` string
- `sort` string, const
- `next` string
- `limit` integer

## Response `200`

Response schema for getting client mobility details

- GetClientMobilityDetails
  - `items` MobilityDetails[], required: A list of mobility details for a client
    - `occurredAt` string: Specifies the transition time of the client.
    - `roamTime` string: Specifies the roaming latency in milliseconds.
    - `wlanName` string: Specifies the network identifier.
    - `sourceAp` string: Specifies the AP name from which the client roamed.
    - `destinationAp` string: Specifies the AP name to which the client roamed.
    - `fromChannel` string: Specifies the channel from which the client roamed.
    - `toChannel` string: Specifies the channel to which the client roamed.
    - `fromBssid` string: Specifies the BSSID MAC address from which the client roamed.
    - `toBssid` string: Specifies the BSSID MAC address to which the client roamed.
    - `rssi` string: Specifies the RSSI value after the client roamed.
    - `radioBand` string: Specifies the radio band to which the client roamed.
    - `roamProtocol` '11r' | 'okc' | '802.11': Specifies the type of roam that has happened.
    - `type` string, const, required: The type of the resource.
    - `id` string, const, required: Primary identifier for the resource.
  - `count` integer, required: The number of mobility events after filtering for a client
  - `total` integer: Total number of events for a client
  - `next` string: Specifies the pagination cursor for the next page of resources. null if there are no further pages.

## Other responses

- `400`: Invalid input received.
- `401`: Unauthorized. Authentication credentials are required or invalid.
- `403`: Forbidden: Access is denied.
- `404`: Not Found error.
- `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)