---
title: "Check up to 10 numbers"
method: POST
path: "/v1/numbers/check"
tags: ["Messages"]
---

# Check up to 10 numbers

`POST /v1/numbers/check`

## Request

- Base URL: `https://www.chatrail.dev`
- URL: `https://www.chatrail.dev/v1/numbers/check`
- Auth: HTTP bearer

The same check for several numbers. Each gets its own line in `results`, in the order sent: a number that cannot be parsed has `reason: invalid_number`, and numbers a spent budget could not reach have `reason: minute_limit` or `daily_limit` instead of failing the request. Repeats in one request are looked up once.

## Request body

- object
  - `connection` string, required
  - `phones` string[], required

## Response `200`

One result per number.

## Other responses

- `400`: No numbers, or more than 10.
- `404`: No such connection.

---

[API](https://skmtc.dev/chatrail/apis/chatrail-api.md) · [All operations](https://skmtc.dev/chatrail/apis/chatrail-api/llms.txt) · [OpenAPI document](https://skmtc.dev/chatrail/apis/chatrail-api/revisions/acc5b88c6f59?raw)