---
title: "Get Extension Caller ID"
method: GET
path: "/restapi/v1.0/account/{accountId}/extension/{extensionId}/caller-id"
tags: ["User Settings"]
---

# Get Extension Caller ID

`GET /restapi/v1.0/account/{accountId}/extension/{extensionId}/caller-id`

Returns information on an outbound caller ID of an extension.

## Path parameters

- `accountId` string, required
- `extensionId` string, required

## Response `200`

Caller ID information

- ExtensionCallerIdInfo
  - `uri` string, uri — Canonical URL of a caller ID resource
  - `byDevice` CallerIdByDevice[]
    - `device` CallerIdDeviceInfo
      - `id` string — Internal identifier of a device
      - `uri` string, uri — Link to a device resource
      - `name` string — Name of a device
    - `callerId` CallerIdByDeviceInfo
      - `type` string — If 'PhoneNumber' value is specified, then a certain phone number is shown as a caller ID when using this telephony feature. If 'Blocked' value is specified, then a caller ID is hidden. The value 'CurrentLocation' can be specified for 'RingOut' feature only. The default is 'PhoneNumber' = ['PhoneNumber', 'Blocked', 'CurrentLocation']
      - `phoneInfo` CallerIdPhoneInfo
        - `id` string — Internal identifier of a phone number
        - `uri` string, uri — Link to a phone number resource
        - `phoneNumber` string — Phone number in [E.164](https://www.itu.int/rec/T-REC-E.164-201011-I) (with '+' sign) format
  - `byFeature` CallerIdByFeature[]
    - `feature` 'RingOut' | 'RingMe' | 'CallFlip' | 'FaxNumber' | 'AdditionalSoftphone' | 'Alternate' | 'CommonPhone' | 'MobileApp' | 'Delegated'
    - `callerId` CallerIdByFeatureInfo
      - `type` string — If 'PhoneNumber' value is specified, then a certain phone number is shown as a caller ID when using this telephony feature. If 'Blocked' value is specified, then a caller ID is hidden. The value 'CurrentLocation' can be specified for 'RingOut' feature only. The default is 'PhoneNumber' = ['PhoneNumber', 'Blocked', 'CurrentLocation']
      - `phoneInfo` CallerIdPhoneInfo
        - `id` string — Internal identifier of a phone number
        - `uri` string, uri — Link to a phone number resource
        - `phoneNumber` string — Phone number in [E.164](https://www.itu.int/rec/T-REC-E.164-201011-I) (with '+' sign) format
  - `extensionNameForOutboundCalls` boolean — If `true`, then user first name and last name will be used as caller ID when making outbound calls from extension
  - `extensionNumberForInternalCalls` boolean — If `true`, then extension number will be used as caller ID when making internal calls

---

[API](https://skmtc.net/ringcentral/apis/ringcentral-api.md) · [All operations](https://skmtc.net/ringcentral/apis/ringcentral-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringcentral/ringcentral-api/versions/8d602198ec97/schema)