✛ Data

Phone Number Check

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.

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.

POST/v1/phone/check
Try it free ↓
Price
$0.00016 per check · REST and MCP
RapidAPI
$0.0002 per check · listing at launch
Returns
application/json
MCP tool
phone_check_check

Request body

FieldTypeDescription
numberrequiredstringThe number as typed: +40 721 234 567, 0721 234 567, (212) 555-0123.
countrystringTwo-letter country to assume when the number has no + prefix, such as RO or US.
example
curl https://readymadeapi.com/v1/phone/check \
  -H "Authorization: Bearer $READYMADE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "country": "RO",
    "number": "0721 234 567"
  }'
What comes back
{
  "valid": true,
  "reason": null,
  "e164": "+40721234567",
  "international": "+40 721 234 567",
  "national": "0721 234 567",
  "country": "RO",
  "calling_code": 40,
  "type": "mobile"
}

Try it · 20 free runs a day across all APIs, reset at 00:00 UTC · $0.00016 per check with your key

No key yet? Get an API key · it works for every API.

Use it from an agent

Every endpoint above is also an MCP tool. Add the server to Claude, Cursor or any MCP client and the tools appear with their prices; calls draw from the same credit.

Connect guide · OpenAPI 3.1 spec · llms.txt

mcp config
{
  "mcpServers": {
    "readymade": {
      "type": "http",
      "url": "https://readymadeapi.com/mcp",
      "headers": {
        "Authorization": "Bearer ${READYMADE_KEY}"
      }
    }
  }
}