Reference Solutions Tutorials Visual Designer
    • REST API
      • Overview
        • API Endpoint
        • Authentication
        • Requests
        • Responses
        • Paging
      • Voice
        • Available Phone Numbers
        • Calls
          • Call List Resource URI
          • Making a Call
          • Modifying Live Calls
          • Examples
          • List Filter
          • Paging Information
        • Clients
          • Create a Client
          • Delete a Client
          • Change Client’s Password
          • Get a List of Available Clients
        • Conference Management
          • Supported Operations
          • Conference List Resource URI
        • Conference Participants Management
          • Participants List Resource URI
        • Incoming Phone Numbers
          • IncomingPhoneNumber Instance Resource
          • IncomingPhoneNumbers List Resource
          • Local IncomingPhoneNumber Factory Resource
          • Toll-Free IncomingPhoneNumber Factory Resource
          • Mobile IncomingPhoneNumber Factory Resource
          • Attach a phone number to an application
          • Delete a phone number
          • List of Phone Numbers
          • Incoming Phone Number Regex Support
        • Recordings
        • SIP Refer Support
      • SMS
        • Available Phone Numbers
        • Clients
          • Create a Client
          • Delete a Client
          • Change Client’s Password
          • Get a List of Available Clients
        • Incoming Phone Numbers
          • IncomingPhoneNumber Instance Resource
          • IncomingPhoneNumbers List Resource
          • Local IncomingPhoneNumber Factory Resource
          • Toll-Free IncomingPhoneNumber Factory Resource
          • Mobile IncomingPhoneNumber Factory Resource
          • Attach a phone number to an application
          • Delete a phone number
          • List of Phone Numbers
          • Incoming Phone Number Regex Support
        • Messages
          • Send SMS
          • Get SMS List
          • Get single SMS Information
          • SMS Attributes
        • Email
      • Accounts
      • Applications
      • Notifications
      • Usage Records
    • RCML
      • Overview
        • How wlparam:replace[textMode="sps",parmText="application_name",text="Restcomm",defaultText="$INFER_FROM_DOMAIN"
        • RCML Verbs
      • Dial
        • Client
        • Conference
        • Number
        • SIP
      • Email
      • Gather
      • Say
      • Play
      • SMS
      • Hangup
      • Pause
      • Redirect
      • Record
      • Reject
    • Solution APIs
      • Two-Factor Authentication (2FA)
docs 1.0
  • docs
    • 1.0
  • docs
  • Enterprise:RCML
  • Enterprise:Reject

Reject

Reject

The <Reject> verb rejects an incoming call to your Restcomm endpoint and can be used for blocking unwanted calls. If the first verb in a RCML response is <Reject>, Restcomm will not pick up the call. The call ends with ‘busy', 'no-answer' or other status, depending on the verb’s 'reason' attribute. Any verbs after <Reject> are ignored and won’t be executed.

Reject Attributes

Name Allowed Values Default Value

reason

<See table below>

rejected

reason. The reason attribute takes the values from a table below.

Reason Internal SIP Error and reason phrase Status Purpose

rejected

603 DECLINE

Will play a standard not-in-service response

busy

486 BUSY

Will play a busy signal to the caller

forbidden

403 Forbidden

Untrusted IP origin/source

anonymity_disallowed

433 Anonymity Disallowed

Calling party is anonymous and destination does not accept those calls

address_incomplete

484 Address Incomplete

Wrong destination. regex scenario for number not valid (decision made by the external app still in inbound logic)

no_route

404 No Route

No route to the destination (provider without routing agreement for some countries) if the App makes the decision there is no route to destination dialed (outbound logic)

service_unavailable

503 Service Unavailable

Redirect traffic to other PoP due to many factors (external App behaving bad, low quality, cloud issues faced, etc)

unwanted

607 Unwanted

Calling party in a blacklist

Nesting

The <Reject> verb can not have any other verbs or nouns nested.

Examples

Below is an example of how you can use the <Reject> verb.

<Response> <Reject reason="busy"/> </Response>

Products

Programmable Voice

Programmable SMS

Use Cases

Two-Factor Authentication (2FA)

Phone Number Masking

Voicemail to Email Application

Learn

Terms And Conditions

Contact us

Telestax