API Pemeriksa Nomor Botim

Periksa nomor telepon secara batch untuk registrasi Botim lalu unduh hasil ekspor.

Parameter produk

Parameter	Nilai
Jenis tugas	botim
Jenis input	Nomor telepon format E.164
Minimum entri valid	500

estimated_amount dihitung dari harga akun dan menjadi acuan biaya tugas.

Format input

Unggah file .txt atau .csv dengan satu nomor per baris. Format E.164 disarankan.

+14155552671
+442071838750

Buat tugas

POST https://api.checknumber.ai/v1/tasks

curl --location 'https://api.checknumber.ai/v1/tasks' \
--header 'X-API-Key: YOUR_API_KEY' \
--form 'file=@"./numbers.txt"' \
--form 'task_type="botim"'

API mengembalikan ID tugas. Simpan untuk polling status.

Respons unggah

{
  "task_id": "d4g8o46p2jvh04o9uolg",
  "status": "pending",
  "total": 500,
  "estimated_amount": {
    "amount": "0.250000",
    "currency": "USD"
  },
  "message": "Task created successfully"
}

Periksa status tugas

POST https://api.checknumber.ai/v1/gettasks

curl --location 'https://api.checknumber.ai/v1/gettasks' \
--header 'X-API-Key: YOUR_API_KEY' \
--form 'task_id="d4g8o46p2jvh04o9uolg"'

Polling hingga status menjadi exported. pending dan processing belum selesai.

Respons pemrosesan

{
  "task_id": "d4g8o46p2jvh04o9uolg",
  "status": "processing",
  "total": 500,
  "success": 250,
  "failure": 0
}

Respons ekspor

{
  "task_id": "d4g8o46p2jvh04o9uolg",
  "status": "exported",
  "total": 500,
  "success": 500,
  "failure": 0,
  "result_url": "https://example-link-to-results.zip",
  "actual_amount": {
    "amount": "0.250000",
    "currency": "USD"
  }
}

Kolom hasil

Kolom	Deskripsi	Contoh
number / Number	Nomor telepon input. CSV memakai number; XLSX memakai Number.	+14155552671
activated	Apakah akun terdeteksi untuk nomor tersebut.	yes / no

Baris tanpa akun menghasilkan activated=no; kolom profil kosong jika datanya tidak tersedia.

Pemrosesan file hasil

Unduh paket dari result_url hanya setelah diekspor dan pertahankan nama kolom.

Kolom respons

Kolom	Deskripsi
created_at	Waktu pembuatan tugas.
updated_at	Waktu pembaruan terakhir.
task_id	ID tugas unik.
status	pending, processing, exported, atau failed.
total	Total input valid.
success	Nilai yang berhasil diproses.
failure	Nilai yang gagal.
result_url	URL unduhan setelah ekspor.
actual_amount	Biaya akhir jika tersedia.
estimated_amount	Estimasi biaya saat tugas dibuat.

Kode status

Status	Deskripsi
200	Permintaan berhasil.
202	Tugas dibuat dan estimasi biaya diterapkan.
400	File tidak valid, tipe tidak didukung, atau entri kurang dari minimum.
401	API Key hilang atau tidak valid.
402	Saldo tidak cukup.
404	Tugas tidak ditemukan.
413	File terlalu besar.
500	Kesalahan internal; coba lagi nanti.

Catatan operasional

• Tugas bersifat asinkron; polling dengan ID tugas.
• Hanya nomor valid dan ternormalisasi yang dihitung.
• Tugas gagal dikembalikan dananya sesuai alur penagihan.