Telefonnummern-Intelligence. Leitungstyp, Netzbetreiber, Portierungshistorie, Betrugssignale.
MNP-fähige Carrier-Abfrage über dieselben Leitungen, die auch den SMS- und Voice-Traffic von Bird transportieren. Ein Endpunkt, dieselbe Authentifizierung, dasselbe Fehlerformat wie bei jedem anderen Bird-Kanal – weil dasselbe Engineering-Team alles gebaut hat.
5 minutes from npm install to first lookup
Fragen Sie eine Nummer in der Sprache ab, die Sie bereits verwenden.
SDKs für jede gängige Laufzeitumgebung. Lookup-Antworten in unter 300 ms im Median – schnell genug, um einen SMS-Versand davon abhängig zu machen.
Code samples arrive when this API ships. The SDKs already cover the live channels.
Zehn Felder, die Sie sonst von drei Anbietern zusammenstellen müssten.
Konkrete Datenpunkte, benannt und überprüfbar. Jeder stammt aus einer echten Quelle, nicht aus einem Modell, das rät.
- 01
Leitungstyp-Erkennung
Mobil, Festnetz, VoIP, gebührenfrei, Premium, Pager. Entscheiden Sie, ob SMS überhaupt möglich ist, bevor Sie senden.
- 02
Netzbetreiber-Identifikation
Aktueller Netzbetreibername und Ländercode pro E.164-Eingabe. Laufend gegen MNP-Register aktualisiert.
- 03
Portierungshistorie
Der vorherige Netzbetreiber, von dem die Nummer portiert wurde. Nützlich für Routing-Kostenprognosen und Betrugsheuristiken.
- 04
Land- und Regionsformat
Gibt E.164-, nationale und internationale Formatierung zurück; die Länder- und Regionscodes, die ein Router benötigt.
- 05
Betrugssignale
Ein fraud_score von 0–1 pro Nummer, basierend auf Geschwindigkeit, Leitungstyp-Heuristiken, Kürzlich-portiert-Flags und Negativlisten.
- 06
Gültigkeit und Erreichbarkeit
Ein boolesches „valid
- 07
Batch-Abfrage
Senden Sie per POST eine Liste von bis zu 1.000 Nummern in einem Aufruf. Der gleiche Pro-Nummer-Preis gilt; Sie sparen die Roundtrips.
- 08
Cache-bewusstes Pricing
Ein 24-Stunden-Cache für identische Eingaben ist kostenlos. Sie zahlen nur, wenn sich die Antwort tatsächlich unterscheiden würde.
- 09
Webhooks für Batch-Aufträge
Für große Batches abonnieren Sie lookup.completed und lesen die Ergebnisdatei, anstatt eine HTTP-Verbindung offen zu halten.
- 10
Dieselbe Authentifizierung, dasselbe Fehlerformat
Ein API-Schlüssel für Lookup, SMS, Email, WhatsApp, Voice. Ein einheitliches Fehlertyp-Register für alle.
Warum wir Lookup entwickelt haben
Weil Sie nicht erst erfahren sollten, dass eine Nummer ein Festnetzanschluss ist, indem die SMS fehlschlägt.
Wir haben MNP-Abfragen bereits innerhalb des Bird SMS-Routings durchgeführt – das mussten wir, um in Echtzeit die günstigste Carrier-Route zu wählen. Lookup ist genau diese Abfrage, bereitgestellt als vollwertiger Endpunkt. So können Sie Registrierungen prüfen, Risiken bewerten und Routing-Kosten prognostizieren, ohne eine einzige SMS zu senden. Dieselbe Authentifizierung, dasselbe Fehlerformat, dieselben Webhooks wie auf der gesamten Plattform.
Jede Statusänderung ist ein Webhook.
HMAC-signierte Payloads, Replay-geschützt, idempotent. Einzelnummern-Abfragen sind synchron; Batch-Abfragen werden als Webhooks verteilt.
Retry-Zeitplan: 5s, 30s, 5m, 30m, 2h, 6h, 12h. Dead-Letter nach dem letzten Versuch; jedes Dead-Letter-Event kann über das Dashboard oder die API erneut abgespielt werden.
lookup.completedEine Abfrage (einzeln oder Batch) wurde abgeschlossen. Die Payload enthält die vollständige Antwort.lookup.failedDie Abfrage konnte nicht durchgeführt werden; die Payload enthält das Fehlerformat.
Nummer abfragen, dann an sie senden.
Dieselbe Authentifizierung, derselbe Idempotenz-Vertrag, dasselbe Fehlerformat. Lookup ist wie jeder andere Endpunkt aufgebaut. Der Unterschied: Es liefert Daten zurück, statt eine Nachricht zu versenden.
Lookup.
Carrier, Leitungstyp, Portierungsherkunft, Betrugssignale – synchron zurückgeliefert in unter 300 ms.
SMS.
Dieselbe Authentifizierung, dasselbe Fehlerformat. Machen Sie den Versand vom Lookup-Ergebnis abhängig: Sortieren Sie Festnetznummern aus, bevor sie Kosten verursachen.