---
title: "Get a list of Access Point Tunnels"
method: GET
path: "/network-monitoring/v1/aps/{serial-number}/tunnels"
tags: ["Access Points"]
---

# Get a list of Access Point Tunnels

`GET /network-monitoring/v1/aps/{serial-number}/tunnels`

This API endpoint retrieves a list of tunnels associated with a specific access point, based on the query parameters provided. Each tunnel in the returned list includes comprehensive details like tunnel name, status, encapsulation, source and destination IP etc. The query parameters allow you to narrow down the results to tunnel that meet specific criteria, ensuring you receive only the relevant data.

## Path parameters

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

## Query parameters

- `site-id` string, const — The unique identifier of the site to which the access point has been assigned.
- `filter` string, const
- `sort` string, const
- `limit` integer
- `next` string — Specifies the pagination cursor for the next page of resources.

## Response `200`

List of access point tunnels, along with their details and associated pagination information.

- AccessPointTunnelListResponseV1
  - `items` object[], required
    - `tunnelName` string, const, required — The name of the tunnel.
    - `index` string, const, required — The index of the tunnel
    - `destinationName` string — The serial number or Host Name of the audit.
    - `destinationMacAddress` string, const — The MAC address of the destination endpoint.
    - `destinationIpAddress` string, const — The IP address of the destination endpoint.
    - `status` string, const, required — The current status of the tunnel.
    - `encapsulationType` string, const, required — The encapsulation type used for the tunnel.
    - `cryptoType` 'TUNNEL_CRYPTO_TYPE_UNSPECIFIED' | 'TUNNEL_CRYPTO_TYPE_CERTIFICATE' | 'TUNNEL_CRYPTO_TYPE_PSK' — The cryptographic key exchange type used by the tunnel.
    - `sourceIpAddress` string, const — The source IP address of the tunnel.
    - `lastChangeReason` string, const — The reason for the last status change of the tunnel.
    - `uptimeInMillis` integer — The uptime of the tunnel in milliseconds.
    - `active` boolean — Indicates whether the tunnel is active.
    - `tunnelId` string, const, required — Tunnel ID of an access point tunnel
    - `id` string, const, required — Identifier for the resource.
    - `type` string, const, required — The type of the resource.
  - `count` integer, required — Number of items in the response.
  - `total` integer — Specifies the total number of items available for a given filter query.
  - `next` string, int32, required — Indicate the next page number, 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.
- `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.net/arubanetworks/apis/authorization.md) · [All operations](https://skmtc.net/arubanetworks/apis/authorization/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/arubanetworks/authorization/revisions/74c95058b11f/schema)