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

# Vobiz Messaging API: Number lookup

> Check up to 100 phone numbers against the mobile network without messaging them: validity, reachability, country, network, porting and roaming.

The Number lookup endpoints check phone numbers against the mobile network, without sending them a message. Use them to clean a list before a [broadcast](https://www.vobiz.ai/docs/sms/api/broadcasts), or to validate a number when someone signs up.

| Endpoint | What it does |
| - | - |
| [`POST /Lookup/`](https://www.vobiz.ai/docs/sms/api/lookup/lookup-numbers) | Looks up to 100 numbers and returns one result per distinct number |
| [`GET /Lookup/History/`](https://www.vobiz.ai/docs/sms/api/lookup/list-lookup-history) | Lists your past lookups, newest first |

Both paths are relative to `https://api.vobiz.ai/api/v1/Account/{auth_id}/Sms`.

## What each result tells you

| Field | Meaning |
| - | - |
| `valid` | `true` when the number exists and is reachable |
| `country` | The number's country |
| `network`, `originalNetwork` | The network that serves the number now, and the one that issued it |
| `ported`, `portedNetwork` | Whether the number moved to another network, and which one |
| `roaming`, `roamingNetwork` | Whether the handset is roaming, and on which network |
| `cached` | `true` when the result was reused from a lookup in the last 24 hours |
| `checkedAt` | When the network was asked |

## Caching and limits

* **Results are cached for 24 hours.** A lookup of the same number within 24 hours reuses the earlier result. Set `fresh` to `true` to ask the network again.
* **1,000 network lookups per account per UTC day.** Cached results and inputs that can't be read as phone numbers don't count toward it.
* **Numbers without a country code** are read using `defaultCountry`, which defaults to `US`.


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