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

# Coverage and data

> Which numbers work, what the carrier field means, and how to send numbers.

## +1 numbers only

Mobile Intel covers the North American Numbering Plan (NANP): the US, Canada and the Caribbean countries that use +1. Any other country returns `verdict: "invalid"` with the reason `not a valid NANP number (format)`.

## What the data is

Answers come from numbering allocation data: which carrier each block of numbers was given to, and what type of line it is. There's no live network check. So:

* **Carrier is the original carrier.** It's the carrier the number's block was first allocated to. If someone moved their number to another carrier, `carrier` can still show the old one.
* **It doesn't check if a phone is on.** A `valid` number can be disconnected or unused. The API can't tell you whether a call or text will reach someone.

You can see how much data the service holds and how current it is with [`GET /api/v1/stats`](https://docs.mobileintelapi.com/api-reference/service/data-coverage).

## Sending numbers

| Format | Example | Works? |
| - | - | - |
| E.164 with encoded plus | `?number=%2B14169670000` | Yes |
| 10 digits | `?number=4169670000` | Yes |
| 11 digits with leading 1 | `?number=14169670000` | Yes |
| Formatted, in a `POST` body | `"+1 (416) 967-0000"` | Yes |
| Bare plus in a query string | `?number=+14169670000` | Avoid: in a query string `+` means a space |

> [!TIP]
>
> Let your HTTP library build the query string (`params=` in Python's `requests`, `URLSearchParams` in Node), or use the batch `POST`. Both handle the `+` for you.

## Matching results to your input

* In a batch, results come back in the same order as `numbers`. Result `i` is for number `i`.
* `e164` is normalised (`+14169670000`), so it's safe to join on.
* `international_number` and `local_number` are display formats (`+1 416-967-0000`, `(416) 967-0000`). Don't join on them.


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