v1

latestOpenAPI 3.0.3RingCentral API License Agreement2026-08-064871,2921.5 MB
Automatic Location Updates

Get User Emergency Location

Returns a personal emergency response location for the current user.

get/restapi/v1.0/account/{accountId}/extension/{extensionId}/emergency-locations/{locationId}

Path parameters

accountIdstring required

Internal identifier of the RingCentral account (can be set to "~" to indicate that the account associated with current authorization session should be used)

extensionIdstring required

Internal identifier of the RingCentral extension/user (can be set to "~" to indicate that the extension associated with current authorization session should be used)

locationIdstring required

Internal identifier of an emergency response location

Response

Success

idstring

Internal identifier of an emergency response location

namestring

Emergency response location name

addressStatus'Valid' | 'Invalid' | 'Provisioning'

Emergency address status

usageStatus'Active' | 'Inactive'

Status of emergency response location usage.

syncStatus'Verified' | 'Updated' | 'Deleted' | 'ActivationProcess' | 'NotRequired' | 'Unsupported' | 'Failed'

Resulting status of emergency address synchronization. Returned if syncEmergencyAddress parameter is set to true

addressType'LocationWithElins' | 'LocationWithEndpoint'
visibility'Private' | 'Public'

Visibility of an emergency response location. If Private is set, then location is visible only for the restricted number of users, specified in owners array

addressFormatIdstring

Address format ID