Question 1

What does TwilioLookup API do?

Accepted Answer

Twilio Lookup is a real-time phone number intelligence API that provides instant validation, carrier identification, line type detection, and fraud signals for any phone number globally. Built on Twilio's extensive carrier network relationships, Lookup enables developers to query phone number metadata before sending SMS messages, onboarding users, or processing transactions — helping reduce messaging failures, detect fraud, and route communications optimally.

For Nigerian developers, Twilio Lookup is particularly useful for identifying which of the four main Nigerian carriers (MTN, Airtel, Glo, 9mobile) a given number belongs to, detecting VoIP numbers commonly used in fraud, and identifying SIM Swap events that signal potential account takeovers.

## What the API Does

Twilio Lookup v2 provides phone intelligence through a modular add-on system. The base request provides free E.164 format validation and number standardization. Paid add-ons provide richer intelligence:

**Basic Lookup (Free)**: Validates phone number format, returns E.164 and national format, and confirms the number exists in Twilio's records. No carrier data.

**Carrier Lookup ($0.005/lookup)**: Returns the carrier name, mobile country code, mobile network code, and line type (mobile/landline/VoIP) for the phone number. For Nigerian numbers, this identifies which carrier (MTN Nigeria, Airtel Nigeria, Globacom, 9mobile) the number is on.

**Line Type Intelligence (paid add-on)**: Classifies numbers into: mobile, landline, fixed VoIP, non-fixed VoIP, toll-free, or unknown. This classification is available for all countries worldwide.

**SIM Swap**: Detects recent SIM card changes on a mobile number — a critical fraud signal indicating potential account hijacking. Returned as hours since last SIM change.

**Caller Name (CNAM)**: Returns the registered name for the phone number (primarily US numbers, limited international availability).

## How Developers Use It

Twilio Lookup is a simple REST API. A single GET request to `https://lookups.twilio.com/v2/PhoneNumbers/{PhoneNumber}` returns the requested intelligence. Add query parameters to enable specific packages:

```
GET /v2/PhoneNumbers/+2348012345678?Fields=line_type_intelligence,sim_swap
```

Authentication uses your Twilio Account SID and Auth Token as HTTP Basic Auth credentials.

## Pricing & Fees

- **Basic validation**: Free — no charge for E.164 format lookup.
- **Carrier lookup**: $0.005 per lookup (half a cent per number checked).
- **Line Type Intelligence**: Paid add-on — pricing available at twilio.com/en-us/user-authentication-identity/pricing/lookup.
- **SIM Swap**: Per-query fee varies by country.
- **Caller Name**: Per-query fee for supported regions.

## Authentication

HTTP Basic Authentication using your Twilio Account SID (username) and Auth Token (password). These are found in the Twilio Console. For production use, Twilio recommends creating scoped API Keys rather than using the master Auth Token directly.

## Rate Limits

Standard Twilio account-level rate limits apply. These vary by account tier. Contact Twilio support or review the Console for your account's specific limits.

## Compliance & Regulations

Twilio is ISO 27001 certified, SOC 2 Type II attested, and GDPR compliant. Twilio Lookup processes phone number metadata without storing user personal information beyond what is necessary for query processing. For Nigerian deployments, the carrier and line type data returned by Lookup can support CBN KYC requirements around phone number verification as part of customer due diligence.

## Challenges & Gotchas for Nigerian Developers

1. **VoIP detection for fraud**: Nigerian number fraud often uses VoIP numbers. Always check line_type_intelligence during registration and block non-fixed VoIP registrations.
2. **SIM Swap coverage**: SIM swap detection coverage varies by carrier. Confirm Nigerian carrier coverage (MTN, Airtel, Glo, 9mobile) is included before relying on this feature for fraud prevention.
3. **Carrier lookup cost vs. value**: At $0.005/lookup, checking every user registration costs $5 per 1,000 users. For high-volume apps, model this cost against the fraud prevention value.
4. **USD billing**: Twilio charges in USD. Use a USD virtual card or wire transfer.
5. **CNAM limited for Nigeria**: Caller name lookup has limited availability outside the US. Do not rely on CNAM for Nigerian number enrichment.

## Company Background

Twilio Lookup is part of Twilio's User Authentication and Identity product suite, operated by Twilio Inc. (NYSE: TWLO), a publicly listed cloud communications company founded in 2008 in San Francisco. Twilio's global carrier network and data partnerships power the phone intelligence provided by Lookup.

## Frequently Asked Questions

**Q: Is basic phone number validation really free?**
A: Yes. E.164 format validation and number standardization via Twilio Lookup is completely free with no per-query charge.

**Q: Which Nigerian carriers can Twilio Lookup identify?**
A: MTN Nigeria, Airtel Nigeria, Globacom (Glo), and 9mobile (formerly Etisalat) are all identifiable through the carrier lookup feature.

**Q: Can I detect SIM Swap for Nigerian users?**
A: Yes, but availability depends on the specific carrier's data-sharing agreements with Twilio. Confirm Nigerian carrier SIM Swap coverage with Twilio support before deploying.

**Q: Does Lookup integrate with Twilio Verify?**
A: Yes. Twilio Verify uses Lookup internally for carrier validation. You can use Lookup independently as a pre-send check before triggering Verify OTPs.

Question 2

How much does TwilioLookup API cost?

Accepted Answer

TwilioLookup API is free to start, with paid tiers for higher usage (freemium). Basic phone number validation: FREE. Carrier lookup: $0.005/lookup. Line Type Intelligence (mobile/landline/VoIP/toll-free): paid add-on. SIM swap and caller identity: additional per-query fees.

Question 3

How do I authenticate with the TwilioLookup API API?

Accepted Answer

Account SID + Auth Token (HTTP Basic Auth)

Question 4

Is there a rate limit on TwilioLookup API?

Accepted Answer

Account-level rate limits apply. Contact Twilio for specifics.

Question 5

Does TwilioLookup API offer a sandbox or test mode?

Accepted Answer

Yes — TwilioLookup API provides a sandbox or test environment so you can integrate and test before going live.

Question 6

What is TwilioLookup API best suited for?

Accepted Answer

Nigerian fintechs and messaging platforms that need real-time phone number intelligence — carrier ID, line type (mobile vs VoIP), SIM swap detection, and number format validation — before sending SMS or onboarding users.

Question 7

Is there anything else I should know before integrating TwilioLookup API?

Accepted Answer

Basic E.164 format validation is completely free. Carrier lookup at $0.005/lookup confirms Nigerian carrier (MTN, Airtel, Glo, 9mobile) and whether the number is mobile vs VoIP. SIM Swap detection is critical for Nigerian fintech fraud prevention.

Question 8

Where can I find TwilioLookup API's documentation?

Accepted Answer

The official API documentation is at https://www.twilio.com/docs/lookup/v2-api. The provider's website is https://www.twilio.com/en-us/user-authentication-identity/lookup.

Question 9

Does TwilioLookup API support Nigerian developers?

Accepted Answer

Yes — TwilioLookup API explicitly supports Nigerian developers/use cases.

TwilioLookup API

Features Included

Not Supported

Key Highlights

Required Access Documents

Use Cases

Ask question or give feedback

Sign in to participate

Discover similar API's

Ask question or give feedback

Sign in to participate