---
"@context": https://schema.org
"@type": TechArticle
"@id": https://www.twilio.com/docs/voice/twiml/reject#article
headline: "TwiML™ Voice: <Reject>"
description: Twilio Programmable Voice reference guide for the TwiML <Reject> verb, used to block unwanted incoming calls without incurring charges.
url: https://www.twilio.com/docs/voice/twiml/reject
inLanguage: en
dateModified: 2026-06-22T10:15:32.000Z
author:
  "@type": Organization
  name: Twilio Developer Education Team
publisher:
  "@type": Organization
  name: Twilio
---

# TwiML™ Voice: \<Reject>

The TwiML™ Voice `<Reject>` verb allows you to reject incoming calls to your Twilio number without being billed, which is useful for blocking unwanted calls. Use this reference page to learn about its attributes, nesting rules, and implementation examples. See [Related how-to documentation](#related-how-to-documentation) to learn the steps to use the info on this page.

If the first verb in a TwiML document is `<Reject>`, Twilio will not pick up the call. The call ends with a status of `busy` or `no-answer`, depending on the verb's `reason` attribute. Any verbs after `<Reject>` are unreachable and ignored.

Using `<Reject>` as the first verb in your response is the only way to prevent Twilio from answering a call. Any other response will result in an answered call and your account will be billed.

## Verb Attributes \[#attributes]

The `<Reject>` verb supports the following attributes that modify its behavior:

| Attribute Name               | Allowed Values     | Default Value |
| :--------------------------- | :----------------- | :------------ |
| [reason](#attributes-reason) | `rejected`, `busy` | `rejected`    |

### reason \[#attributes-reason]

The `reason` attribute takes the values `rejected` and `busy`. This tells Twilio what message to play when rejecting a call. Selecting `busy` will play a busy
signal to the caller, while selecting `rejected` will play a standard not-in-service response. The default is `rejected`.

> \[!NOTE]
>
> This is a preference and what is actually played back is determined by the caller's service provider as they dictate what they want to playback to the caller.

## Nesting Rules \[#nesting-rules]

You can't nest any verbs within `<Reject>` and you can't nest `<Reject>` in any other verbs.

## Examples \[#examples]

### Example 1: Reject a call playing a standard not-in-service message \[#examples-1]

Reject a call playing a standard not-in-service message

```js
const VoiceResponse = require('twilio').twiml.VoiceResponse;

const response = new VoiceResponse();
response.reject();

console.log(response.toString());
```

```py
from twilio.twiml.voice_response import Reject, VoiceResponse

response = VoiceResponse()
response.reject()

print(response)
```

```cs
using System;
using Twilio.TwiML;
using Twilio.TwiML.Voice;


class Example
{
    static void Main()
    {
        var response = new VoiceResponse();
        response.Reject();

        Console.WriteLine(response.ToString());
    }
}
```

```java
import com.twilio.twiml.voice.Reject;
import com.twilio.twiml.VoiceResponse;
import com.twilio.twiml.TwiMLException;


public class Example {
    public static void main(String[] args) {
        Reject reject = new Reject.Builder().build();
        VoiceResponse response = new VoiceResponse.Builder().reject(reject)
            .build();

        try {
            System.out.println(response.toXml());
        } catch (TwiMLException e) {
            e.printStackTrace();
        }
    }
}
```

```go
package main

import (
	"fmt"

	"github.com/twilio/twilio-go/twiml"
)

func main() {
	twiml, _ := twiml.Voice([]twiml.Element{
		&twiml.VoiceReject{},
	})

	fmt.Print(twiml)
}
```

```php
<?php
require_once './vendor/autoload.php';
use Twilio\TwiML\VoiceResponse;

$response = new VoiceResponse();
$response->reject();

echo $response;
```

```rb
require 'twilio-ruby'

response = Twilio::TwiML::VoiceResponse.new
response.reject

puts response
```

```xml
<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Reject />
</Response>
```

### Example 2: Reject a call playing a busy signal \[#examples-2]

Reject a call playing a busy signal

```js
const VoiceResponse = require('twilio').twiml.VoiceResponse;

const response = new VoiceResponse();
response.reject({
  reason: 'busy',
});

console.log(response.toString());
```

```py
from twilio.twiml.voice_response import Reject, VoiceResponse

response = VoiceResponse()
response.reject(reason='busy')

print(response)
```

```cs
using System;
using Twilio.TwiML;
using Twilio.TwiML.Voice;


class Example
{
    static void Main()
    {
        var response = new VoiceResponse();
        response.Reject(reason: "busy");

        Console.WriteLine(response.ToString());
    }
}
```

```java
import com.twilio.twiml.voice.Reject;
import com.twilio.twiml.VoiceResponse;
import com.twilio.twiml.TwiMLException;


public class Example {
    public static void main(String[] args) {
        Reject reject = new Reject.Builder().reason(Reject.Reason.BUSY).build();
        VoiceResponse response = new VoiceResponse.Builder().reject(reject)
            .build();

        try {
            System.out.println(response.toXml());
        } catch (TwiMLException e) {
            e.printStackTrace();
        }
    }
}
```

```go
package main

import (
	"fmt"

	"github.com/twilio/twilio-go/twiml"
)

func main() {
	twiml, _ := twiml.Voice([]twiml.Element{
		&twiml.VoiceReject{
			Reason: "busy",
		},
	})

	fmt.Print(twiml)
}
```

```php
<?php
require_once './vendor/autoload.php';
use Twilio\TwiML\VoiceResponse;

$response = new VoiceResponse();
$response->reject(['reason' => 'busy']);

echo $response;
```

```rb
require 'twilio-ruby'

response = Twilio::TwiML::VoiceResponse.new
response.reject(reason: 'busy')

puts response
```

```xml
<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Reject reason="busy" />
</Response>
```

## Related how-to documentation

Find how-to documentation for the topics on this page.

* [Respond to incoming phone calls](/docs/voice/tutorials/how-to-respond-to-incoming-phone-calls)
