Check that a +1 number is real, which network it is on and whether it can receive a message right now. Runs on the same key as your United States SMS and email.
10DLC registration is mandatory for application-to-person traffic on long codes. Alphanumeric sender IDs are not deliverable. Opt-out keywords must be honoured automatically and confirmed to the recipient.
Opt-out keywords honoured automatically: STOP, UNSUBSCRIBE, CANCEL, END, QUIT, STOPALL.
us.woyra.ioGlobal
curl "https://us.woyra.io/v1/lookups/+1712345678?type=carrier" \
-H "Authorization: Bearer $WOYRA_KEY"
# {"valid": true, "carrier": {"name": "...", "type": "mobile"}, "reachable": true}The same key works on every endpoint. Calling us.woyra.io applies United States's rules and, where residency requires it, keeps the data in the global region.
Numeric senders, 10DLC registration required · billed in USD · global data region
A lookup asks the network, not a table: whether the number exists, which operator holds it today including numbers that have moved between them, and whether the handset is reachable right now. Run it at sign-up and you stop paying to send codes to numbers that were never going to receive one.
Woyra accepts the formats people and spreadsheets actually produce — spaces, hyphens, brackets, a leading 00 — and refuses only what cannot be routed. A United States number without its country code is refused rather than guessed at, because no system can know which country a national number belongs to.
An account on the United States endpoint is billed in US dollars today. Billing in USD is where this is going, and it is a real advantage when it arrives, but a converted price needs a published rate behind it and there is not one yet, so we quote one currency rather than invent a second. Funds are reserved at the published price when a message is accepted and settled when it is delivered; a message we never deliver is never charged for, and a hard spend cap you set is enforced rather than invoiced.
Global The residency of a message is decided when it is accepted and travels with it, so it cannot be moved later by a query written somewhere else.
Every mobile network operating in United States, including numbers that have been ported between them.
$0.004, billed in USD. A format-only check is free.
Global
E.164: a plus, the country code +1, then the subscriber number, as in +1712345678. Woyra strips spaces, hyphens, brackets and a leading 00, but it will not guess a missing country code, because the same digits belong to a different subscriber in every country.
us.woyra.io, though the same API key works on every endpoint Woyra runs. Which one you call decides the compliance rules applied, the currency you are billed in, and — where residency requires it — which data plane answers.