---
title: "Retrieve Phone's detailed information."
method: GET
path: "/phones/{mac}"
tags: ["Auto Provisioning"]
---

# Retrieve Phone's detailed information.

`GET /phones/{mac}`

Retrieve phone's detailed information.

## Path parameters

- `mac` string, required — MAC address.

## Response `200`

OK

- object
  - `extension_number` string — The extension number.
  - `vendor` string — The phone vendor of IP phone.
  - `model` string — The name of IP phone model.
  - `fwver` string — The firmware version of IP phone.
  - `name` string — The display name of user.
  - `password` string — Password for accessing the Web interface of phone. The username remains default because most phone manufacturers do not allow modification of the user name. This is supported for some phone model, such as "Snom 300".
  - `vm_pin` string — The voicemail PIN of the phone.
  - `ip` string — IP address.
  - `mac` string — MAC address.

## Other responses

- `404` — Not Found

---

[API](https://skmtc.net/portsip/apis/portsip-pbx-rest-api.md) · [All operations](https://skmtc.net/portsip/apis/portsip-pbx-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/portsip/portsip-pbx-rest-api/revisions/577415d4a3d5/schema)