Documentation

Quickstart

1. Sign in with Google and copy your default API key.
2. Send a GET request to https://api.telephone.so/v1/validate.
3. Pass the number as phone and the key as a Bearer token.

curl "https://api.telephone.so/v1/validate?phone=+14155552671" \
  -H "Authorization: Bearer tel_YOUR_API_KEY"

API reference

GET /v1/validate?phone=+14155552671

POST /v1/validate/bulk with { "phones": ["+14155552671"] }

Host: https://api.telephone.so. Header: Authorization: Bearer tel_…

{
  "phone": "+14155552671",
  "valid": true,
  "possible": true,
  "format": {
    "international": "+1 415 555 2671",
    "national": "(415) 555-2671",
    "e164": "+14155552671"
  },
  "country": { "code": "US", "calling_code": "1" },
  "type": "FIXED_LINE_OR_MOBILE"
}

• 400 — missing phone
• 401 — missing or invalid API key
• 403 — no active subscription
• 422 — number could not be parsed

SDKs & libraries

Any HTTP client works. There is no required SDK. Bulk endpoint: https://api.telephone.so/v1/validate/bulk

const res = await fetch(
  "https://api.telephone.so/v1/validate?phone=+14155552671",
  { headers: { Authorization: "Bearer tel_YOUR_API_KEY" } },
);
const data = await res.json();

Interactive examples with your live key are in the dashboard docs.