फ़ोन-नंबर इंटेलिजेंस। लाइन टाइप, कैरियर, ported-from, फ़्रॉड सिग्नल।
MNP-aware carrier lookup over the same wires that carry Bird's SMS and Voice traffic. One endpoint, same auth, same error envelope as every other Bird channel, because the same engineering team built them all.
5 minutes from npm install to first lookup
जिस भाषा का आप पहले से इस्तेमाल करते हैं, उसी से नंबर लुकअप करें।
SDKs in every major runtime. Lookup answers in under 300ms at the median, fast enough to gate an SMS send on it.
Code samples arrive when this API ships. The SDKs already cover the live channels.
दस फ़ील्ड जिन्हें अन्यथा आप तीन वेंडरों से जोड़ रहे होते।
ठोस डेटा पॉइंट, नामित और ऑडिट-योग्य। हर एक किसी असली स्रोत से आता है, किसी अनुमान लगाते मॉडल से नहीं।
- 01
लाइन-टाइप डिटेक्शन
Mobile, landline, VoIP, toll-free, premium, pager. भेजने से पहले तय करें कि SMS संभव भी है या नहीं।
- 02
कैरियर पहचान
प्रति E.164 इनपुट वर्तमान कैरियर का नाम और country code। MNP रजिस्ट्री के मुकाबले लगातार अपडेट किया जाता है।
- 03
Ported-from इतिहास
पिछला कैरियर जिससे नंबर पोर्ट किया गया था। रूटिंग-लागत पूर्वानुमान और फ़्रॉड heuristics के लिए उपयोगी।
- 04
देश और क्षेत्र फ़ॉर्मैट
E.164, national और international फ़ॉर्मैटिंग लौटाता है; और वे country तथा region codes जो एक router को चाहिए।
- 05
फ़्रॉड सिग्नल
प्रति नंबर 0-1 का एक fraud_score, जो velocity, लाइन-टाइप heuristics, हाल के पोर्ट फ़्लैग और known-bad लिस्ट को मिलाता है।
- 06
वैधता और पहुँच-योग्यता
A boolean valid and a reachable window: some numbers parse fine but the carrier no longer assigns them.
- 07
Batch lookup
एक ही कॉल में 1,000 तक नंबरों की लिस्ट POST करें। वही प्रति-नंबर प्राइसिंग लागू होती है; आप राउंड ट्रिप बचाते हैं।
- 08
Cache-अवेयर प्राइसिंग
समान इनपुट पर 24h का cache मुफ़्त है। आप तभी भुगतान करते हैं जब जवाब वाकई अलग होता।
- 09
Batch jobs के लिए webhooks
बड़े batches के लिए, lookup.completed को subscribe करें और HTTP कनेक्शन बनाए रखने के बजाय रिज़ल्ट फ़ाइल पढ़ें।
- 10
वही auth, वही error envelope
Lookup, SMS, Email, WhatsApp, Voice के लिए एक API key। इन सबमें एक ही error type registry।
हम Lookup क्यों बनाते हैं
क्योंकि आपको यह SMS फ़ेल होते देखकर नहीं जानना चाहिए कि कोई नंबर landline है।
We were already running MNP lookups inside Bird SMS routing: we had to, to pick the cheapest carrier route in real time. Lookup is that same query, surfaced as a first-class endpoint, so you can gate signups, score risk, and forecast routing cost without sending a single SMS. Same auth, same error envelope, same webhooks as the rest of the platform.
हर state change एक webhook है।
HMAC-signed payloads, replay-protected, idempotent। सिंगल-नंबर लुकअप synchronous होते हैं; batch लुकअप webhooks के रूप में fan out होते हैं।
Retry शेड्यूल: 5s, 30s, 5m, 30m, 2h, 6h, 12h. आख़िरी प्रयास के बाद dead-letter; हर dead-lettered इवेंट dashboard या API से replay किया जा सकता है।
lookup.completedएक lookup (सिंगल या batch) पूरा हुआ। Payload में पूरा response शामिल है।lookup.failedLookup नहीं किया जा सका; payload में error envelope शामिल है।
नंबर लुकअप करें, फिर उसी पर भेजें।
Same auth, same idempotency contract, same error envelope. Lookup is shaped like every other endpoint. The difference is that it returns data instead of dispatching a message.
Lookup.
Carrier, line type, ported-from, fraud signals: returned synchronously in under 300ms.
SMS.
Same auth, same error envelope. Gate the send on the lookup result: drop the landlines before they cost you.