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	Required
number	required
region	optional
default_region	optional
lang	optional

Try in playground →

post/phone-validate/v1/batch2 credits

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

Parameter	Required
numbers	required
region	optional
default_region	optional
lang	optional

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
}