POST /api/v1/bulk-taskscurl -X POST "https://api.carrierlookup.online/api/v1/bulk-tasks" \
-H "X-API-Key: sk_your_api_key" \
-F service_type=number_validation_batch \
-F country=US \
-F [email protected]Dapatkan sinyal validitas atau aktivasi tiap nomor melalui tugas berkas asinkron. Hasil true/false mendukung peninjauan daftar impor, pembersihan data, dan pemeliharaan CRM.
Produk ini hanya tersedia sebagai tugas berkas asinkron. Pencarian operator waktu nyata tidak mengembalikan sinyal validitas atau aktivitas.
Pengiriman langsung mengembalikan ID tugas; periksa tugas dengan ID tersebut dan, setelah berhasil, respons membawa tautan unduhan file hasil. Setiap permintaan ditampilkan bersama responsnya.
ID tugas langsung dikembalikan dengan preparing bernilai true selama file disiapkan di latar belakang: baris tidak valid, duplikat, dan — untuk tugas nomor — nomor tanpa kode negara atau dari negara lain dihapus dan tidak ditagihkan. Saldo dicadangkan untuk baris yang dikirim dan diselesaikan saat tugas selesai; selisihnya dikembalikan.
POST /api/v1/bulk-taskscurl -X POST "https://api.carrierlookup.online/api/v1/bulk-tasks" \
-H "X-API-Key: sk_your_api_key" \
-F service_type=number_validation_batch \
-F country=US \
-F [email protected]200 OK{
"code": 0,
"msg": "ok",
"data": {
"id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
"product": "number_validation_batch",
"status": "processing",
"country": "US",
"submitted_lines": 509,
"total": 509,
"invalid_cnt": 0,
"no_code_cnt": 0,
"other_country_cnt": 0,
"duplicate_cnt": 0,
"preparing": true,
"created_at": "2026-09-08T09:30:00Z"
}
}Lakukan polling berdasarkan ID tugas. Setelah persiapan selesai, submitted_lines = total + invalid_cnt + no_code_cnt + other_country_cnt + duplicate_cnt, dengan total adalah jumlah yang diperiksa dan ditagihkan. Respons yang berhasil membawa jumlah keberhasilan dan kegagalan serta tautan unduhan file hasil; tugas yang ditolak selama persiapan berstatus failed dengan reason_detail dan dikembalikan sepenuhnya.
GET /api/v1/bulk-tasks/{id}curl "https://api.carrierlookup.online/api/v1/bulk-tasks/3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13" \
-H "X-API-Key: sk_your_api_key"200 OK{
"code": 0,
"msg": "ok",
"data": {
"id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
"product": "number_validation_batch",
"status": "success",
"country": "US",
"submitted_lines": 509,
"total": 500,
"invalid_cnt": 3,
"no_code_cnt": 0,
"other_country_cnt": 0,
"duplicate_cnt": 6,
"preparing": false,
"success_cnt": 495,
"failure_cnt": 5,
"result_url": "https://…/result.csv",
"created_at": "2026-09-08T09:30:00Z"
}
}Massal bukan sekadar real-time dalam skala besar — kirim sekali, berjalan di latar belakang, ambil kemudian. Anda tidak perlu membiarkan halaman tetap terbuka; status tugas dan hasilnya tetap tersimpan di dasbor Anda.
File .txt atau .csv dengan satu nomor per baris. File langsung dialirkan; tidak ada yang ditulis ke disk.
Masalah yang jelas (file kosong, format salah, baris terlalu sedikit) ditolak saat diunggah. Saldo kemudian dicadangkan dan file disiapkan di latar belakang: baris duplikat dan tidak valid dihapus dan aturan negara diperiksa. File yang gagal pada tahap itu berakhir sebagai tugas gagal dan dikembalikan sepenuhnya; jika tidak, hanya baris yang tersisa yang diperiksa, dan tugas diselesaikan tagihannya saat selesai.
Tugas berjalan dengan sendirinya — Anda boleh menutup halaman. Kegagalan langsung dilaporkan dan dikembalikan sepenuhnya.
Ambil file dari halaman pemeriksaan massal. Anda hanya membayar untuk nomor yang benar-benar mengembalikan hasil; selisihnya dikembalikan.
Unduhan berupa satu file CSV dengan tabel hasil lengkap.
identifier · 12345678900 — Nomor yang dikirim dalam bentuk angka polos dengan kode negara, tanpa tanda plus atau spasi (mis. 12345678900), sekaligus kunci stabil untuk mencocokkan hasil dengan data pelanggan, prospek, atau CRM. Simpan untuk menelusuri daftar sumber dan menuliskan hasil kembali secara massal; kolom ini saja tidak membuktikan bahwa nomor dapat dihubungi.activated · true — Keputusan validitas/aktivasi: true berarti cocok pada pemeriksaan ini, false berarti negatif yang tegas. Jangan ubah hasil kosong atau gagal menjadi false. Tidak membuktikan identitas, izin menghubungi, atau keterjangkauan panggilan.Setelah mengimpor daftar pendaftaran atau prospek, tinjau hasil bersama data formulir, aturan antipenipuan, dan persetujuan. Pemeriksaan asinkron ini tidak menggantikan verifikasi kode saat pendaftaran.
Cocokkan identifier dengan catatan asli dan simpan sumbernya untuk tinjauan manual.
Kunci pencocokan: identifier
Setelah ekspor, tandai data berdasarkan sinyal aktivasi sambil tetap menyimpan nomor asli dan kolom sumber; arahkan sinyal yang hilang atau tidak biasa ke peninjauan alih-alih langsung menghapus data bisnis.
Pisahkan true, false, dan hasil kosong; simpan hasil kosong dalam antrean peninjauan.
Kolom pengelompokan: activated
Tuliskan tanggal pemeriksaan, produk, dan hasil ke kolom CRM khusus agar tim pemasaran, layanan, dan data dapat bekerja dari status daftar yang sama dalam alur kerja berikutnya.
Simpan hasil dengan tanggal tugas yang dicatat tim. Kirim tugas baru jika perlu diperbarui.
Kolom pembaruan: identifier · activated
Periksa nomor E.164 secara massal sebelum menjangkau pelanggan dan dapatkan nomor beserta sinyal aktivasinya. Gunakan hasilnya untuk menandai data yang perlu ditinjau, membersihkan daftar, dan menjaga kualitas data CRM; sinyal yang dikembalikan tidak menjamin panggilan atau pesan akan tersambung.
True adalah kecocokan pada pemeriksaan ini dan false adalah negatif yang tegas. Keduanya merupakan keputusan; false bukan kegagalan eksekusi atau baris gratis. Tangani hasil kosong, tidak dapat ditentukan, dan gagal secara terpisah menurut statistik tugas dan penyelesaian biaya; jangan isi sebagai false.
Tidak. Tidak ada jendela pengamatan, tanggal aktif terakhir, frekuensi, atau riwayat interaksi, dan tidak ada jaminan panggilan atau pesan tersampaikan. Gunakan dengan data bisnis dan izin menghubungi Anda.
Produk ini hanya tersedia sebagai tugas berkas asinkron. Pencarian operator waktu nyata tidak mengembalikan sinyal validitas atau aktivitas.
Pemeriksaan awal membuang baris yang formatnya salah, sehingga tidak pernah masuk ke jumlah yang ditagihkan. Dari nomor yang tersisa, nomor yang tidak dapat diselesaikan oleh layanan hulu juga tidak ditagihkan. Anda hanya membayar untuk nomor yang benar-benar mengembalikan hasil.
Tergantung pada jumlah nomor dan produknya. Anda dapat menutup halaman setelah mengirim; tugas berjalan di latar belakang dan hasilnya menunggu Anda di halaman pemeriksaan massal.
Ya. Tugas yang gagal dikembalikan sepenuhnya. Jika tugas berhasil tetapi sebagian nomor tidak mengembalikan apa pun, bagian tersebut dikembalikan secara otomatis. Selisih antara jumlah yang dicadangkan dan yang benar-benar ditagihkan selalu dikembalikan.
Pemeriksaan massal dan real-time menggunakan saldo yang sama — tidak ada yang perlu diaktifkan tambahan. Daftar dan unggah file pertama Anda di halaman pemeriksaan massal.