Skip to main content

GetExtensionInfoResponse

Properties

NameTypeRequiredDescription
id_intInternal identifier of an extension
uristrCanonical URI of an extension
accountGetExtensionAccountInfoAccount information
contactContactInfoDetailed contact information
cost_centerCostCenterInfoCost center information. Applicable if Cost Center feature is enabled. The default is root cost center value
custom_fieldsList[CustomFieldInfo]
departmentsList[DepartmentInfo]Information on department extension(s), to which the requested extension belongs. Returned only for user extensions, members of department, requested by single extensionId. Please note that legacy 'Department' extension type corresponds to 'Call Queue' extensions in modern RingCentral product terminology
extension_numberstrExtension short number
extension_numbersList[str]
namestrExtension name. For user extension types the value is a combination of the specified first name and last name
partner_idstrFor Partner Applications Internal identifier of an extension created by partner. The RingCentral supports mapping of accounts and stores the corresponding account ID/extension ID for each partner ID of a client application. In request URIs partner IDs are accepted instead of regular RingCentral native IDs as path parameters using pid=XXX clause. Though in response URIs contain the corresponding account IDs and extension IDs. In all request and response bodies these values are reflected via partnerId attributes of account and extension
permissionsExtensionPermissionsExtension permissions, corresponding to the Service Web permissions 'Admin' and 'InternationalCalling'
profile_imageProfileImageInfoInformation on profile image
referencesList[ReferenceInfo]List of non-RC internal identifiers assigned to an extension
rolesList[Roles]
regional_settingsRegionalSettingsRegional data (timezone, home country, language) of an extension/account. The default is Company (Auto-Receptionist) settings
service_featuresList[ExtensionServiceFeatureInfo]Extension service features is returned in response only when the logged-in user requests their own extension info, see also Extension Service Features
setup_wizard_stateSetupWizardStateForUpdateEnumInitial configuration wizard state
statusGetExtensionInfoResponseStatusExtension current state. If 'Unassigned' is specified, then extensions without extensionNumber are returned. If not specified, then all extensions are returned
status_infoExtensionStatusInfoStatus information (reason, comment). Returned for 'Disabled' status only
type_GetExtensionInfoResponseTypeExtension type. Please note that legacy 'Department' extension type corresponds to 'Call Queue' extensions in modern RingCentral product terminology
sub_typeGetExtensionInfoResponseSubTypeExtension subtype, if applicable. For any unsupported subtypes the Unknown value will be returned
call_queue_infoCallQueueExtensionInfoFor Call Queue extension type only. Please note that legacy 'Department' extension type corresponds to 'Call Queue' extensions in modern RingCentral product terminology
hiddenboolHides extension from showing in company directory. Supported for extensions of User type only
siteProvisioningSiteInfoSite data. If multi-site feature is turned on for an account, then ID of a site must be specified. In order to assign a wireless point to the main site (company) the site ID should be set to main-site
assigned_countryAssignedCountryInfoInformation on a country assigned to an extension user. Returned for the User extension type only

GetExtensionInfoResponseStatus

Extension current state. If 'Unassigned' is specified, then extensions without extensionNumber are returned. If not specified, then all extensions are returned

Properties

NameTypeRequiredDescription
ENABLEDstr"Enabled"
DISABLEDstr"Disabled"
FROZENstr"Frozen"
NOTACTIVATEDstr"NotActivated"
UNASSIGNEDstr"Unassigned"

GetExtensionInfoResponseType

Extension type. Please note that legacy 'Department' extension type corresponds to 'Call Queue' extensions in modern RingCentral product terminology

Properties

NameTypeRequiredDescription
USERstr"User"
FAXUSERstr"FaxUser"
FLEXIBLEUSERstr"FlexibleUser"
VIRTUALUSERstr"VirtualUser"
DIGITALUSERstr"DigitalUser"
DEPARTMENTstr"Department"
ANNOUNCEMENTstr"Announcement"
VOICEMAILstr"Voicemail"
SHAREDLINESGROUPstr"SharedLinesGroup"
PAGINGONLYstr"PagingOnly"
IVRMENUstr"IvrMenu"
APPLICATIONEXTENSIONstr"ApplicationExtension"
PARKLOCATIONstr"ParkLocation"
BOTstr"Bot"
ROOMstr"Room"
ROOMCONNECTORstr"RoomConnector"
LIMITEDstr"Limited"
SITEstr"Site"
PROXYADMINstr"ProxyAdmin"
DELEGATEDLINESGROUPstr"DelegatedLinesGroup"
GROUPCALLPICKUPstr"GroupCallPickup"

GetExtensionInfoResponseSubType

Extension subtype, if applicable. For any unsupported subtypes the Unknown value will be returned

Properties

NameTypeRequiredDescription
VIDEOPROstr"VideoPro"
VIDEOPROPLUSstr"VideoProPlus"
DIGITALSIGNAGEstr"DigitalSignage"
UNKNOWNstr"Unknown"
EMERGENCYstr"Emergency"

Build Your Own SDKs with  liblab

Build developer friendly SDKs in minutes from your APIs

Start for Free →