---
title: "Get ap coverage plan for a given AP serial number"
method: GET
path: "/network-services/v1/airmatch-ap-coverage-plan/{serial-number}"
tags: ["AirMatch"]
---

# Get ap coverage plan for a given AP serial number

`GET /network-services/v1/airmatch-ap-coverage-plan/{serial-number}`

## Request

- Base URL: `https://sso.common.cloud.hpe.com`
- URL: `https://sso.common.cloud.hpe.com/network-services/v1/airmatch-ap-coverage-plan/{serial-number}`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://sso.common.cloud.hpe.com/as/token.oauth2`
- TypeScript: <https://skmtc.dev/arubanetworks/apis/authorization/docs/network-services/v1/airmatch-ap-coverage-plan/:serial-number/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns AP Coverage Plan for a given AP Serial Number for a tenant

## Path parameters

- `serial-number` string, required

## Query parameters

- `id` string[]
- `limit` integer
- `offset` integer

## Response `200`

Successful operation

- ApCoveragePlan: AP coverage plan document
  - `id` string, required
  - `type` string, required
  - `apOpmode` string
  - `apSerial` string
  - `updateTimestamp` integer
  - `feasibleOpmodeSnapshotTimestamp` integer
  - `effectiveTimestamp` integer
  - `requestId` string
  - `tenantId` string
  - `siteId` string
  - `docCount` integer

## Other responses

- `400`: Bad Request. Validation errors in the request body or parameters, or invalid parameters for the specific device.
- `401`: Unauthorized. Authentication credentials are required or invalid.
- `403`: Forbidden request. The client does not have access rights to the content.
- `404`: Requested resource was 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)