---
title: "Get extension number"
method: GET
path: "/extension_numbers/{extension_number}"
tags: ["Extension"]
---

# Get extension number

`GET /extension_numbers/{extension_number}`

## Request

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

Get details by extension number.

## Path parameters

- `extension_number` string, required: The extension number.

## Response `200`

OK

- object
  - `id` string: The unique ID of the resource.
  - `extension_number` string: The extension number.
  - `name` string: The name of this Ext.
  - `type` 'EXTENSION' | 'RING_GROUP' | 'CALL_QUEUE' | 'CONFERENCE_ROOM' | 'VIRTUAL_RECEPTIONIST': User agent client includes: - `EXTENSION`: type of extension type. - `RING_GROUP`: type of ring group. - `CALL_QUEUE`: type of call queue. - `CONFERENCE_ROOM`: type of conference room. - `VIRTUAL_RECEPTIONIST`: type of virtual receptionist.

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