---
title: "Get AP information of a specific AP Ethernet MAC"
method: GET
path: "/network-services/v1/airmatch-ap/{serial-number}"
tags: ["AirMatch"]
---

# Get AP information of a specific AP Ethernet MAC

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

## Request

- Base URL: `https://sso.common.cloud.hpe.com`
- URL: `https://sso.common.cloud.hpe.com/network-services/v1/airmatch-ap/{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/:serial-number/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns Access Point (AP) Information based on its Serial number for a given tenant

## Path parameters

- `serial-number` string, required

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

Successful operation

- ApInfo: AP document from aps collection
  - `id` string, required
  - `type` string, required
  - `apCurrentOpmode` string
  - `apEthMac` string
  - `apModel` string
  - `apName` string
  - `apGreenStateUpdtime` string
  - `apInGreenState` 'true' | 'false'
  - `apSerial` string
  - `apTimestamp` integer
  - `apTimezone` string
  - `apUptime` string
  - `customerMode` string
  - `ipAddr` string
  - `ipAddr6` string
  - `isApDown` 'true' | 'false'
  - `siteId` string
  - `updateTimestamp` integer
  - `updatedTs` 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)