API v1.0 · Live

CARRIER & NUMBER
LOOKUP
ONE API CALL AWAY.

One endpoint returns the carrier, country, line type (mobile, landline, VoIP), timezones and every standard format — single or batch, sub-second.

Everything included

One endpoint. Every signal you need.

Carrier detection

Identify the mobile or landline carrier for numbers worldwide.

Country + region

ISO country codes, region and human-readable location strings.

Number type

Mobile, landline, VoIP, toll-free, premium — cleanly classified.

Timezones

All applicable time zones for the region the number belongs to.

Every format

E.164, international, national, and RFC 3966 in one response.

Batch of 50

POST an array of numbers, get parallel results in a single call.

Sub-second

Fetched from an edge worker with aggressive upstream timeouts.

API keys + logs

Rotate, revoke, expire. Every request logged for full auditability.

For developers

Bearer token in. JSON out.

Pick your stack. Every sample calls the same endpoint with the same shape.

  • RESTful JSON — no SDK required
  • CORS enabled on every endpoint
  • Rotate & revoke keys instantly
  • Per-request analytics in your dashboard
Read the docs
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://numscope.lovable.app/api/v1/lookup?phone=%2B14155551234"
Use cases

Ship real features, faster.

Fraud checks

Flag disposable, VoIP and high-risk carriers at signup.

SMS routing

Pick the cheapest carrier gateway per destination.

CRM enrichment

Auto-fill country, carrier and format on every lead.

KYC & compliance

Verify number ownership shape before manual review.

240+
Countries covered
1,800+
Carriers detected
<400ms
Avg response time
99.9%
Uptime SLO
Pricing

Free tier. Generous limits. No credit card.

Start with a personal API key today. Upgrade when you need higher throughput.