docs / phone-validate

Phone Validation

Validate and format phone numbers worldwide.

base /phone-validate/v12 endpoints

post/phone-validate/v1/validate1 credit

validate ONE number → validity + format/region/line-type/carrier/timezone/location

Parameter		Allowed / range	Description
number	required	—	The phone number to validate. Best supplied in E.164 (+countrycode…); a national number works too if you also pass `region`.
region	optional	—	Default ISO-3166 alpha-2 region (e.g. TR, US, DE, GB) used to parse NATIONAL-format numbers that have no +country-code. Ignored for E.164 input. Case-insensitive.
lang = en	optional	—	Language for the carrier name + geocoded location text (e.g. en, de, fr, es). Falls back to English.

Try in playground →

post/phone-validate/v1/batch2 credits

validate up to 100 numbers in one call (shared default region)

Parameter		Allowed / range	Description
numbers	required	—	Up to 100 phone numbers. A JSON array, OR a comma/newline-separated string. Each is validated independently (a bad entry → is_valid=false, never fails the call).
region	optional	—	Default ISO-3166 alpha-2 region (e.g. TR, US, DE, GB) used to parse NATIONAL-format numbers that have no +country-code. Ignored for E.164 input. Case-insensitive.
lang = en	optional	—	Language for the carrier name + geocoded location text (e.g. en, de, fr, es). Falls back to English.

Try in playground →

Example request · validate

curl -X POST https://api.reefapi.com/phone-validate/v1/validate \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"number":"+90 532 123 4567"}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}