---
title: "Retrieve profile of firmware template"
method: GET
path: "/phone_models/{filename}"
tags: ["Auto Provisioning"]
---

# Retrieve profile of firmware template

`GET /phone_models/{filename}`

## Request

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

Retrieve phone template profile by it's filename.

## Path parameters

- `filename` string, required: Template XML file name for phone provisioning.

## Response `200`

OK

- object
  - `filename` string: Template XML file name for phone provisioning.
  - `languages` string[]: A collection of language tags.
  - `ringtones` string[]: A collection of ringtones.
  - `queue_ringtones` string[]: A collection of queue ringtones.
  - `external_ringtone` string[]: A collection of external ringtones.
  - `date_formats` string[]: A collection of date formats.
  - `time_formats` string[]: A collection of time formats.
  - `powerleds` string[]: A collection of time power leds.
  - `backlights` string[]: A collection of time backlights.
  - `screensavers` string[]: A collection of screensavers.
  - `time_zones` string[]: A collection of time zones.
  - `codecs` string[]: Settings for the priority of the codecs in this phone. This indicates the first preferred codec.
  - `enable_lldp` boolean: Enable or disable Link Layer Discovery Protocol.
  - `enable_vlan_wan_port` boolean: Enable or disable VLAN for WAN Port.
  - `wan_port_id` integer: VLAN ID for WAN PORT.
  - `wan_port_priority` integer: VLAN priority for WAN Port.
  - `enable_vlan_pc_port` boolean: Enable or disable VLAN for PC Port.
  - `pc_port_id` integer: VLAN ID for PC PORT.
  - `pc_port_priority` integer: VLAN priority for PC Port.

## Other responses

- `4XX`: Error

---

[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)