Cut Wasted SMS Spend
Skip numbers with wrong format before sending. Reduce failed deliveries and lower messaging costs.
Number Lookup API
Carrier Lookup Worldwide.
From €0.0065/query.
Retrieve live carrier data and MCC/MNC for E.164 numbers in real time. Single lookups or bulk jobs up to 1,000 numbers.
REST API with OAuth 2.0 authentication. One global price for all countries. Volume discounts available.
€0.0065/query All countries Bulk up to 1,000
$ curl -X POST https://api.omaxtelecom.com/numbers/number-lookup \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"phone_number": "+38766000111"
}'
// Response
{
"success": true,
"data": { /* carrier lookup result */ }
}Use Cases
What You Can Do with Number Lookup API
Retrieve live carrier data and MCC/MNC to improve messaging routing, fraud prevention, and data enrichment.
Route by Current Network
Identify the carrier behind any E.164 number. Optimise routing, pricing, and delivery logic per network.
Fraud & KYC Screening
Retrieve live carrier data and MCC/MNC during sign-up. Flag suspicious or high-risk numbers early.
Clean CRM & Contact Lists
Enrich contact databases with carrier metadata. Improve data quality before campaigns.
Improve OTP Routing
Resolve the current network behind a number for smarter SMS routing. Higher delivery rates, fewer retries.
Bulk List Enrichment
Process up to 1,000 unique E.164 numbers per bulk job. Async processing with per-number carrier results.
Platform
Features
Developer-friendly REST API built for real-time validation and high-volume batch processing.
Real-Time Single Lookup
POST a single E.164 phone number and receive a sanitized carrier lookup result instantly.
Async Bulk Jobs
Queue bulk carrier lookups with up to 1,000 unique E.164 numbers per request. Poll for results when ready.
OAuth 2.0 Client Credentials
Secure authentication via RFC 6749 Client Credentials grant. Bearer tokens with 5-minute expiry.
One Global Price
€0.0065 per query across all countries. No per-destination rate tables or hidden surcharges.
Health Endpoint
Public service health check at GET /number-lookup/health. No authentication required.
Org-Scoped Job Polling
Bulk jobs are scoped to your organisation. Poll status and retrieve results securely via job ID.
Integration
How It Works
Three steps from credentials to carrier lookups at scale.
01
Get API Credentials
Sign up at console.omaxtelecom.com and obtain your Client ID and Client Secret. Self-service credentials in minutes.
02
Authenticate & Lookup
Exchange credentials for a Bearer token via OAuth 2.0 Client Credentials. Send a single lookup or queue a bulk job.
03
Scale with Bulk Jobs
Submit up to 1,000 unique E.164 numbers per bulk request. Poll job status until completed and retrieve per-number results.
Rates
€0.0065 per Query, All Countries
One flat rate worldwide. No per-destination tables. Volume discounts for high-throughput integrations.
€0.0065
per lookup query
Same price for every country. Single and bulk lookups billed per request.
Up to 10K/month
Standard rates
10K–100K/month
10% discount
100K–1M/month
20% discount
1M+/month
Custom pricing
Each request is charged when price_per_lookup is greater than zero, including cached results. Contact us for custom volume pricing above 1M queries per month.
Quick Start - Your First Lookup
A single API call is all it takes to validate a phone number and retrieve carrier data.
$ curl -X POST https://api.omaxtelecom.com/numbers/number-lookup \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"phone_number": "+38766000111"
}'
// Response
{
"success": true,
"data": { /* carrier lookup result */ }
}Full API reference at developer.omaxtelecom.com
FAQ
Frequently Asked Questions
The Number Lookup API uses OAuth 2.0 Client Credentials (RFC 6749 §4.4). Exchange your Client ID and Client Secret from the OmaxTelecom Console for a Bearer access token at POST /auth/token. Include the token in the Authorization header for all lookup requests.
Single lookup (POST /number-lookup) returns a carrier result for one E.164 phone number immediately. Bulk lookup (POST /number-lookup/bulk) queues an async job for up to 1,000 unique numbers and returns a job_id. Poll GET /number-lookup/bulk/{job_id} until status is completed or failed.
All phone numbers must be in E.164 format: a leading plus sign followed by the country code and subscriber number (e.g. +38766000111). Numbers must match the pattern ^\+[1-9]\d{1,14}$.
Each lookup is charged at €0.0065 when price_per_lookup is greater than zero. Billing applies per request regardless of whether the result is served from cache. Volume discounts are available at 10K+, 100K+, and 1M+ queries per month.
Yes. GET /number-lookup/health is a public endpoint that returns whether the service is globally operational. No authentication is required.
Complete documentation including request/response schemas is available at developer.omaxtelecom.com/api/number-lookup. You can also sign up at console.omaxtelecom.com to get API credentials and start integrating.
Integrate via Number Lookup API
Start validating phone numbers with our REST API. Clear documentation, OAuth 2.0 auth, and developer support.
Number Lookup API Setup
Get a personalised walkthrough of our carrier lookup API, pricing, and integration process.
- API credentials and sandbox access
- Single and bulk lookup walkthrough
- Volume pricing for your use case
- Live Q&A with our team
No credit card required · Setup in 48 hours · Cancel anytime
Prefer email? [email protected]
Related Products
Phone Validation API
Validate format and metadata before lookup. Valid/possible, line type, geocoder, and carrier name from €0.002/query.
Learn moreEnterprise SMS
Send promotional, transactional, and 2FA/OTP messages worldwide. Combine with carrier lookup for smarter routing.
Learn moreWholesale DIDs
Virtual phone numbers from around the world. Instant provisioning, flexible SIP routing, and SMS-enabled options.
Learn more