---
title: "GET /client-details/topology/client-trail/{macAddress}"
method: GET
path: "/client-details/topology/client-trail/{macAddress}"
tags: ["Client - Details"]
---

# GET /client-details/topology/client-trail/{macAddress}

`GET /client-details/topology/client-trail/{macAddress}`

## Path parameters

- `macAddress` string, required

## Response `200`

OK

- XiqClientConnectionTrailResponse
  - `links` XiqTopologyViewLink[]
    - `source` integer
    - `source_port_id` string
    - `source_lag` string
    - `destination` integer
    - `destination_port_id` string
    - `destination_lag` string
    - `index` integer
    - `connected` boolean
    - `connection_mode` 'LLDP' | 'CLIENT' | 'UNKNOWNDEVICE' | 'MESH' | 'VGVA' | 'FAKEGATEWAY'
  - `nodes` XiqTopologyViewNode[]
    - `id` integer
    - `hostname` string
    - `mac_address` string
    - `ip_address` string
    - `port_number` string
    - `radio_info` string
    - `health_score` integer
    - `client_count` integer
    - `last_node` boolean
    - `topology_start_node` boolean
    - `connected` boolean
    - `vlan_info` XiqTopologyViewNodeVlanInfo
      - `mgmt_vlan` integer
      - `native_vlan` integer
      - `access_port_vlans` integer[]
      - `trunk_port_vlans` integer[]
      - `user_profile_vlans` integer[]
    - `type` 'WIRELESS_CLIENT' | 'WIRED_CLIENT' | 'UNKNOWN' | 'AP' | 'MESHAP' | 'PORTALAP' | 'SWITCH' | 'ROUTER' | 'VAASL2VG' | 'VAASL3VG' | 'GATEWAY' | 'STACK' | 'APASROUTER' | 'XMCSERVER'
    - `critical_alarms` integer
    - `not_current_location_node` boolean
    - `unknown_device` XiqTopologyUnknownDevice
      - `mac_address` string
      - `hostname` string
      - `type` string
      - `ip_address` string
    - `wired_interface_name` string
    - `connected_port` string
    - `stack_member_info` XiqTopologyStackMemberInfo[]
      - `stack_member_id` integer
      - `device_id` integer
      - `serial_number` string
      - `unit_number` integer
      - `member_type` string
      - `poe_info` XiqTopologyViewNodePoeInfo
        - `power_state` object
        - `unit_power_available` number, double
        - `unit_power_consumed` number, double
        - `unit_power_threshold` number, double
        - `poe_power_available` number, double
        - `poe_power_consumed` number, double
        - `poe_power_threshold` number, double
    - `make` string
    - `position` XiqPosition
      - `x` number, double
      - `y` number, double
    - `poe_info` XiqTopologyViewNodePoeInfo
      - `power_state` object
      - `unit_power_available` number, double
      - `unit_power_consumed` number, double
      - `unit_power_threshold` number, double
      - `poe_power_available` number, double
      - `poe_power_consumed` number, double
      - `poe_power_threshold` number, double
    - `product_type` string
    - `is_locally_managed` boolean
    - `sim_type` string
  - `baseline` boolean
  - `user_initiated` boolean
  - `created_at` integer
  - `zoom` number, double
  - `pan` XiqPosition
    - `x` number, double
    - `y` number, double
  - `neighbors` XiqNeighborAp[]
    - `device_id` integer
    - `hostname` string
    - `ip_address` string
    - `mac_address` string
    - `rssi` integer
    - `connection_failure_reason` 'OTHER' | 'ABORT_FROM_OS' | 'DEASSOC_FROM_AP' | 'DEAUTH_FROM_AP' | 'INTERNAL_TERMINATION' | 'INVALID_CAPABILITIES' | 'ASSOC_FAILURE_802_11' | 'AUTH_FAILURE_802_11' | 'TX_RX_FAILURE_REASON'

---

[API](https://skmtc.net/extremecloudiq/apis/extremecloud-iq-api.md) · [All operations](https://skmtc.net/extremecloudiq/apis/extremecloud-iq-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/extremecloudiq/extremecloud-iq-api/versions/5ff7ab84e8e8/schema)