Sign in
latestOpenAPI 3.0.3RingCentral API License Agreement2026-08-064871,2921.5 MB

8d602198ec97

Call Handling Rules

Get Call Handling Rule

Returns a call handling rule by ID.

get/restapi/v1.0/account/{accountId}/extension/{extensionId}/answering-rule/{ruleId}

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)

ruleIdstring required

Internal identifier of a call handling rule

Query parameters

showInactiveNumbersboolean

Indicates whether inactive numbers should be returned or not

Response

OK

uristring uri

Canonical URI to an answering rule resource

idstring

Internal identifier of an answering rule

type'BusinessHours' | 'AfterHours' | 'Custom'

Type of an answering rule

namestring

Name of an answering rule specified by user

enabledboolean

Specifies if an answering rule is active or inactive

callHandlingAction'ForwardCalls' | 'UnconditionalForwarding' | 'AgentQueue' | 'TransferToExtension' | 'TakeMessagesOnly' | 'PlayAnnouncementOnly' | 'SharedLines'

Specifies how incoming calls are forwarded

screening'Off' | 'NoCallerId' | 'UnknownCallerId' | 'Always'

Call screening status. 'Off' - no call screening; 'NoCallerId' - if caller ID is missing, then callers are asked to say their name before connecting; 'UnknownCallerId' - if caller ID is not in contact list, then callers are asked to say their name before connecting; 'Always' - the callers are always asked to say their name before connecting. The default value is 'Off'