Infrastructure
Know what you are sending to before you send
Resolve a phone number to its carrier, line type, and portability status. Filter landlines out of an SMS list, catch invalid numbers before they cost you a segment, and detect numbers that have been reassigned.
01
Line type detection
Mobile, landline, VoIP, or invalid. Removing landlines from a list before a send is the cheapest deliverability improvement available to you.
02
Current carrier, not the original one
Lookups reflect the number's current carrier after any porting, which is what determines how your message is actually routed and filtered.
03
Reassignment signals
Numbers get disconnected and handed to someone new. Messaging a reassigned number is a TCPA exposure, and lookup gives you an early warning.
04
Batch or real-time
One number at a time in your signup flow, or an entire list before a campaign. Same endpoint, same pricing.
Send your first message
Authentication is a key pair over HTTPS basic auth. There is no SDK requirement — every endpoint is plain REST.
curl "https://api.anthonyoliva.com/v1/lookup/+13155550188" \
-u "$AO_KEY_ID:$AO_KEY_SECRET"
# {
# "phone_number": "+13155550188",
# "national_format": "(315) 555-0188",
# "line_type": "mobile",
# "carrier": "Verizon Wireless",
# "ported": true,
# "country_code": "US"
# }Specifications
- Price
- $0.004 per lookup
- Latency
- Typically under 300 ms
- Returns
- Carrier, line type, country, portability, formatting
- Batch
- Up to 10,000 numbers per request
- Coverage
- United States and Canada
Common use cases
- Validating a phone number at signup
- Cleaning a list before a campaign
- Routing to SMS or voice based on line type
- Reducing spend on undeliverable numbers
Consent still comes first
Every use case above assumes the recipient gave you prior express consent for that specific program. Our Messaging Policy sets out exactly what your call-to-action must disclose and how long you have to keep the proof.
Talk to someone who has read the carrier rules
Tell us what you are sending, to whom, and how they consented. We will tell you honestly whether it will get approved, and what to change if it will not.