cURL-Anfrage
POST /api/v1/bulk-taskscurl -X POST "https://carrierlookup.online/api/v1/bulk-tasks" \
-H "X-API-Key: sk_your_api_key" \
-F service_type=carrier_batch \
-F country=US \
-F file=@numbers.txtMassenprodukt carrier_batch
Globale Netzbetreiber-Abfrage
Laden Sie eine ganze Datei mit Nummern hoch: Netzbetreiber, zugrunde liegender Netzbetreiber, Anschlussart, Land, Region und Stadt für jede Nummer – dieselben Felder wie bei der Netzbetreiber-Abfrage in Echtzeit.
Eine Ergänzung für ganze große Listen – für wenige Nummern antwortet die Echtzeitprüfung in derselben Anfrage. Echtzeitprüfung →
API-Vertrag
Zwei Schritte: Datei übermitteln, dann Aufgabe abfragen
Beim Übermitteln wird sofort eine Aufgaben-ID zurückgegeben; fragen Sie die Aufgabe über diese ID ab, und sobald sie erfolgreich ist, enthält die Antwort den Download-Link für die Ergebnisdatei. Jede Anfrage wird mit ihrer eigenen Antwort gezeigt.
1. Datei übermitteln
Die Aufgaben-ID kommt sofort zurück, mit preparing auf true, während die Datei im Hintergrund vorbereitet wird: Ungültige Zeilen, Duplikate und – bei Nummernaufgaben – Nummern ohne Ländervorwahl oder aus einem anderen Land werden entfernt und nicht berechnet. Für die übermittelten Zeilen wird Guthaben reserviert und bei Abschluss abgerechnet; die Differenz wird erstattet.
Antwort: Aufgabe erstellt
200 OK{
"code": 0,
"msg": "ok",
"data": {
"id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
"product": "carrier_batch",
"status": "processing",
"country": "US",
"submitted_lines": 1015,
"total": 1015,
"invalid_cnt": 0,
"no_code_cnt": 0,
"other_country_cnt": 0,
"duplicate_cnt": 0,
"preparing": true,
"created_at": "2026-09-08T09:30:00Z"
}
}2. Aufgabe abfragen
Fragen Sie über die Aufgaben-ID ab. Nach Abschluss der Vorbereitung gilt submitted_lines = total + invalid_cnt + no_code_cnt + other_country_cnt + duplicate_cnt, wobei total die geprüfte und berechnete Menge ist. Eine erfolgreiche Antwort enthält die Anzahl der Erfolge und Fehlschläge sowie den Download-Link für die Ergebnisdatei; eine bei der Vorbereitung abgelehnte Aufgabe erhält den Status failed mit reason_detail und wird vollständig erstattet.
cURL-Anfrage
GET /api/v1/bulk-tasks/{id}curl "https://carrierlookup.online/api/v1/bulk-tasks/3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13" \
-H "X-API-Key: sk_your_api_key"Antwort: Aufgabe abgeschlossen
200 OK{
"code": 0,
"msg": "ok",
"data": {
"id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
"product": "carrier_batch",
"status": "success",
"country": "US",
"submitted_lines": 1015,
"total": 1000,
"invalid_cnt": 3,
"no_code_cnt": 0,
"other_country_cnt": 0,
"duplicate_cnt": 12,
"preparing": false,
"success_cnt": 990,
"failure_cnt": 10,
"result_url": "https://…/result.csv",
"created_at": "2026-09-08T09:30:00Z"
}
}So läuft es ab
Was mit einer Massenaufgabe passiert
Die Massenprüfung ist keine vergrößerte Echtzeitprüfung – einmal übermitteln, im Hintergrund ausführen, später abholen. Sie müssen die Seite nicht geöffnet lassen; Aufgabenstatus und Ergebnisse bleiben in Ihrem Dashboard.
01Datei hochladen
Eine .txt- oder .csv-Datei mit einer Nummer pro Zeile. Sie wird direkt durchgestreamt; nichts wird auf die Festplatte geschrieben.
02Vorprüfung und Reservierung
Offensichtliche Probleme (eine leere Datei, das falsche Format, zu wenige Zeilen) werden beim Hochladen abgelehnt. Anschließend wird Guthaben reserviert und die Datei im Hintergrund vorbereitet: Doppelte und ungültige Zeilen werden entfernt, und die Länderregel wird geprüft. Eine Datei, die dabei scheitert, endet als fehlgeschlagene Aufgabe und wird vollständig erstattet; andernfalls werden nur die verbleibenden Zeilen geprüft, und die Aufgabe wird bei Abschluss abgerechnet.
03Im Hintergrund ausführen
Die Aufgabe läuft selbstständig – Sie können die Seite gern schließen. Ein Fehlschlag wird sofort gemeldet und vollständig erstattet.
04Ergebnis herunterladen
Holen Sie die Datei auf der Seite der Massenprüfung ab. Sie zahlen nur für Nummern, die tatsächlich ein Ergebnis geliefert haben; die Differenz wird erstattet.
Ergebnisfelder
Spalten der Ergebnisdatei
Der Download ist eine einzelne CSV-Datei mit der vollständigen Ergebnistabelle.
Spalten der Ergebnisdatei
identifier·17253100591— Die übermittelte Nummer als reine Ziffern mit Ländervorwahl, ohne Pluszeichen oder Leerzeichen (z. B. 17253100591).carrier·T-Mobile— Netzbetreiber, dem die Nummer ursprünglich zugeteilt wurde. Nicht der aktuelle Netzbetreiber nach einer Portierung.underlying_carrier— Vom Anbieter gemeldeter zugrunde liegender Netzbetreiber, wenn er vom zugeteilten abweicht; leer, wenn der Anbieter keinen liefert.number_type·Fixed Line or Mobile— Vom Anbieter gemeldete Anschlussart, etwa Fixed Line or Mobile; leer, wenn nicht verfügbar.country_code·US— ISO-Ländercode des Landes, zu dem die Nummer gehört.region·CA— Zuteilungsregion; leer, wenn der Anbieter keine liefert.city·LOS ANGELES— Zuteilungsstadt; leer, wenn der Anbieter keine liefert.
Ideal für
Wann Sie dieses Produkt nutzen sollten
Listensegmentierung
Ordnen Sie eine vollständige Nummernliste in einer herunterladbaren Ergebnisdatei nach ursprünglichem Netzbetreiber, Anschlussart und Zuteilungsland bzw. -region.
Prüfung der Routing-Kosten
Nutzen Sie die Spalten für Netzbetreiber und Region, um interne Routing-, Beschaffungs- oder Kostenunterlagen abzugleichen, ohne Nummern einzeln zu prüfen.
Datenbankpflege
Finden Sie Nummerndatensätze ohne ursprünglichen Netzbetreiber, Region oder Stadt und erstellen Sie eine Liste zur Vervollständigung und manuellen Prüfung. Trennen Sie leere, unvollständige und widersprüchliche Datensätze, damit sie nicht unbemerkt in spätere Analysen gelangen.
Empfohlener Ablauf: Datensätze zur Prüfung markieren, die Liste zur Datenvervollständigung exportieren und sie dann zurückschreiben oder die Abfrage erneut ausführen.
Kurze Antwort
Was ist die Massen-Globale Netzbetreiber-Abfrage?
Die Netzbetreiber-Massenabfrage ist die Dateiversion der Netzbetreiber-Abfrage in Echtzeit, ausgelegt für Listen ab tausend Nummern: Laden Sie eine Datei hoch, die Aufgabe läuft im Hintergrund, und Sie laden eine Ergebnis-CSV mit denselben Feldern für jede Nummer herunter. Jede Nummer muss ihre Ländervorwahl enthalten, und alle Nummern einer Datei müssen zu dem Land gehören, das Sie beim Hochladen wählen; Nummern ohne Ländervorwahl oder aus einem anderen Land werden ausgelassen und nicht berechnet.
Klare Grenzen
Grenzen dieses Produkts
- Es beschreibt das Netz, dem eine Nummer ursprünglich zugeteilt wurde. Die Rufnummernmitnahme wird nicht berücksichtigt, es handelt sich also nicht zwingend um den Netzbetreiber, der die Nummer heute bedient.
- Es ist weder eine Erreichbarkeitsprüfung noch eine Identitätsprüfung: Es sagt nicht, ob die Nummer in Betrieb ist oder wem sie gehört.
- An die Nummern in der Datei wird nichts gesendet – die Abfrage erfolgt anhand von Zuteilungsdaten.
- Die Ergebnisse spiegeln die Zuteilungsdaten zum Zeitpunkt der Ausführung wider; gespeicherte Ergebnisse werden nie automatisch aktualisiert. Eine erneute Ausführung der Datei zeigt nicht, zu welchen Netzbetreibern Nummern portiert wurden.
- Download-Links laufen ab. Rufen Sie die Datei bald nach Abschluss der Aufgabe ab; ist ein Link abgelaufen, fragen Sie die Aufgabe erneut ab, um einen neuen zu erhalten.
Wann sich die Massenprüfung eignet
Wann sich die Massenprüfung lohnt – und wann die Echtzeitprüfung schneller ist
| Echtzeitprüfung | Massenprüfung | |
|---|---|---|
| Wie viele Nummern | 1 Nummer pro Einzelprüfung; mehrere pro Mehrfachanfrage – genaue Obergrenzen stehen in der API-Dokumentation | Eine ganze große Liste in einer Aufgabe – den aktuellen Größenbereich finden Sie auf der Preisseite |
| Ergebnisse erhalten | Sofort: Einzel- und Mehrfach-Endpunkt antworten in derselben Antwort; das Dashboard liefert sie einzeln | Ergebnisdatei herunterladen, sobald die Aufgabe abgeschlossen ist |
| Land | Keine Auswahl nötig – jede Nummer trägt ihre eigene Ländervorwahl, beliebig gemischt in einer Anfrage | Ein Land pro Aufgabe, beim Hochladen ausgewählt und mit der Datei übermittelt |
| Ergebnisform | JSON, Felder pro Nummer | Ergebnisdatei (eine CSV-Datei mit der vollständigen Tabelle) |
| Typische Nutzung | CRM-Anreicherung bei der Erfassung, Abfragen durch Mitarbeitende, Routing-Regeln | Listensegmentierung, Prüfung der Routing-Kosten, Datenbankpflege |
Produkt-FAQ
Über die Globale Netzbetreiber-Abfrage
Wann sollte ich die Massenprüfung statt einer Echtzeitprüfung nutzen?
Nutzen Sie die Massenprüfung für eine ganze große Liste. Für wenige Nummern antwortet die Echtzeitprüfung in derselben Anfrage, ohne dass eine Aufgabe geplant werden muss.
Was passiert mit ungültigen Nummern in der Datei?
Die Vorprüfung verwirft fehlerhafte Zeilen, sodass sie nie in die abrechenbare Anzahl eingehen. Von den verbleibenden Nummern werden auch diejenigen nicht berechnet, die der vorgelagerte Dienst nicht auflösen kann. Sie zahlen nur für Nummern, die tatsächlich ein Ergebnis liefern.
Wie lange dauert eine Aufgabe?
Das hängt von der Anzahl der Nummern und dem Produkt ab. Sie können die Seite nach dem Übermitteln schließen; die Aufgabe läuft im Hintergrund, und das Ergebnis wartet auf der Seite der Massenprüfung auf Sie.
Erhalte ich eine Erstattung, wenn sie fehlschlägt?
Ja. Eine fehlgeschlagene Aufgabe wird vollständig erstattet. Ist die Aufgabe erfolgreich, liefern aber einige Nummern kein Ergebnis, wird dieser Anteil automatisch erstattet. Die Differenz zwischen dem reservierten und dem tatsächlich berechneten Betrag wird immer zurückerstattet.
Erstellen Sie ein Konto, um eine Massenaufgabe zu übermitteln
Massen- und Echtzeitprüfungen greifen auf dasselbe Guthaben zu – es muss nichts zusätzlich aktiviert werden. Registrieren Sie sich und laden Sie Ihre erste Datei auf der Seite der Massenprüfung hoch.