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

# Retrieve Phone's detailed information.

`GET /phones/{mac}`

## Request

- Base URL: `https://HOSTNAME:8887/api`
- URL: `https://HOSTNAME:8887/api/phones/{mac}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/portsip/apis/portsip-pbx-rest-api/docs/phones/:mac/get.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/portsip/apis/portsip-pbx-rest-api.md) - [All operations](https://skmtc.dev/portsip/apis/portsip-pbx-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/portsip/apis/portsip-pbx-rest-api/revisions/577415d4a3d5?raw)