> ## Documentation Index
> Fetch the complete documentation index at: https://docs.topcalls.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Where TopCalls Calls

> Every outbound call is checked before it is dialed: the country, the kind of number and its price. A refused call places nothing and holds no credit.

Before any outbound call rings, TopCalls checks the number it's about to dial. The check runs on every way a call can start: campaign calls and their retries, scheduled calls, test calls, calls placed through the API or MCP, the browser dialer, and the check calls that confirm a number you own. A call can't be placed without passing it.

A refused call places no call and holds no credit.

## What the check looks at

| It refuses | `reason` | What to do |
| - | - | - |
| A number that isn't complete or can't exist | `invalid_number` | Fix the digits. Write it with `+` and the country code |
| A number too short to be a phone number, including emergency numbers such as 112, 911 and 999 | `short_code` | TopCalls never dials emergency services. Use another phone for those |
| A toll-free, pager, personal or premium-rate number | `number_type` | Nothing to enable |
| A Zone 3 country your account hasn't turned on, a number range priced like Zone 3, or a destination with no price on file | `country_not_enabled` | Email [hello@topcalls.ai](mailto:hello@topcalls.ai) with the country. We reply with the price before we turn it on |
| A Zone 4 country | `not_available` | Nothing to enable |
| A number range that costs more per minute than TopCalls dials | `range_above_cap` | Other numbers in the same country still work |

Zone 1 and Zone 2 countries are open on every account. [Pricing and Zones](https://docs.topcalls.ai/concepts/pricing.md) has the price of each zone, and the country search at [topcalls.ai/pricing](https://topcalls.ai/pricing) shows where a country sits.

## Where you see a refusal

* **API:** `POST /v1/calls` answers `422` with `code: destination_not_allowed` and the `reason` above. [Making Calls](https://docs.topcalls.ai/guides/making-calls.md#destination-not-allowed) shows the response.
* **Before you dial:** `GET /v1/pricing/quote` gives the same answer for a number without placing a call, with `allowed: false` and the `reason`.
* **Campaigns:** the call to that lead is marked failed, and its error message says why. It isn't retried and doesn't count toward an automatic pause.
* **Browser dialer:** the call doesn't start, and the panel says the number can't be called.

## Calls to the US and Canada

A `+1` number also needs a number on your account that's allowed to call there. That's a separate check, with its own error (`us_caller_id_required`). [Phone Numbers](https://docs.topcalls.ai/guides/phone-numbers.md#calling-the-us-and-canada) explains it.

## What stays with you

The check decides whether a number can be dialed and at what price. Whether you may call that person is yours to decide: consent, opt-outs and do-not-call registries stay with you. TopCalls never calls a number on your [Block list](https://docs.topcalls.ai/guides/block-list.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.