$0.004 per HLR or carrier lookup

Phone number lookup API: carrier, validity and reachability

Validate a number at sign-up, find its carrier and country, and know whether it can receive an SMS before you spend one. Cheap enough to run on every form submission.

What you get

Format and validity

Is this a real number, in which country, in E.164 form? Answered without a network query, and free when that is all you ask for.

Carrier and ported status

Which network holds the number today, including numbers that have moved between carriers. Useful for routing and for spotting fraud.

Reachability

A live HLR query says whether the handset is currently reachable, so you can skip the SMS that would never arrive.

Cached honestly

Results are cached for a short window and the response says how old they are, so you never pay twice for the same fact within the hour.

The call

The same key works on every country endpoint; which one you call sets the rules and the currency.

curl "https://api.woyra.io/v1/lookups/+254712345678?type=carrier" \
  -H "Authorization: Bearer $WOYRA_KEY"

# {"valid": true, "carrier": {"name": "...", "type": "mobile"}, "reachable": true}

Reference price: Twilio ~$0.005–0.01. Full list on the pricing page.

Questions

What does a lookup cost?

$0.004 for a carrier or reachability lookup. A format check alone is free.

Which countries are covered?

Every country Woyra sends to, and most others for carrier data. Reachability depends on the network answering an HLR query, which most do.

Can I use lookup to block fraud?

Yes. Combine number type, carrier and country with your own signals to refuse VoIP or premium numbers at sign-up, before sending a code.

Is there a bulk endpoint?

Lookups are fast enough to run inline, and the same key works from a job. Ask if you need to check millions at once and we will quote a rate.

Lookup by country

Each market has its own rules, currency and endpoint. Pick yours.

On the same key

Phone number lookup API: carrier, validity and reachability · Woyra