# Reject

The  \<Reject > verb rejects an incoming call to your CallAPI endpoint and can be used for blocking unwanted calls. If the first verb in a RCML response is , CallAPI 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  are ignored and will not be executed.<br>

## Reject Attributes

| Name       | Allowed Values     | Default Value |
| ---------- | ------------------ | ------------- |
| **reason** | \<See table below> | rejected      |

### Reason

{% hint style="info" %}
The reason attribute takes the values from a table below.
{% endhint %}

| 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.

## Example

{% hint style="info" %}
Example of how to use the  \<Reject> verb:
{% endhint %}

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