# Phone Number Validation

Phone validation offline in milliseconds: valid or not, line type, country, and the number in E.164, international and national form.

Send a phone number the way a person typed it, with a default country for numbers written without a prefix. You get back whether it is a valid number for that country, the kind of line (mobile, fixed line, toll free, premium rate, VoIP and more), the country and calling code, and the number written in E.164 for storage plus international and national form for display. It runs offline on Google's libphonenumber data and answers in milliseconds. It checks numbering plans, not whether the line is in service, and it never calls or texts the number.

- A phone number validator that runs offline on Google's libphonenumber data: answers in milliseconds and nothing is looked up at a carrier.
- Never calls or texts the number.
- E.164 for storage plus international and national form for display, and the kind of line: mobile, fixed, toll free, premium rate, VoIP.

## Calls

### `POST https://readymadeapi.com/v1/phone/check`

Parse a phone number as typed and say whether it is valid for its country, what kind of line it is, and how to write it in E.164, international and national form.

- Price: $0.00016 per check
- MCP tool: `phone_check_check`
- Answers in the same call.

Request:

```json
{
  "country": "RO",
  "number": "0721 234 567"
}
```

Answer:

```json
{
  "valid": true,
  "reason": null,
  "e164": "+40721234567",
  "international": "+40 721 234 567",
  "national": "0721 234 567",
  "country": "RO",
  "calling_code": 40,
  "type": "mobile"
}
```

## Limits

- One number per call.

## Questions

**Does it say whether the line is in service?**

No. It checks the number against its country's numbering plan.

**Does it return the carrier or whether the number was ported?**

No. Nothing is looked up at a carrier; you get the country, the kind of line and the number in standard forms.

**What about numbers typed without a country code?**

Send a default country and they are read as a local would write them.

## Using it

- Send `Authorization: Bearer <key>` and a JSON body. Keys and credit: https://readymadeapi.com/account
- Every answer carries `X-Request-Id`, `X-Units` and `X-Charged-Usd`.
- An error is a JSON problem with a `title` to act on and a `detail` in plain words; nothing is charged for it.
- Full schema: https://readymadeapi.com/openapi.json
