API Pengecekan Email Massal: Gmail, Outlook, Yahoo & Lainnya

Verifikasi alamat email mana di daftar yang Anda unggah yang terdaftar di Gmail, Outlook, Yahoo, Mail.ru, atau iCloud. Menggunakan task_type email_check dan alur polling batch yang sama dengan pengecekan lainnya.

Unggah file deteksi — contoh:

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

Periksa status tugas — contoh:

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

Respons setelah unggahan berhasil

{
    "task_id": "d4g8o46p2jvh04o9uolg",
    "status": "pending",
    "total": 2000,
    "estimated_amount": {
        "amount": "0.500000",
        "currency": "USD"
    },
    "message": "Task created successfully",
    "created_at": "2025-11-21T15:58:08.916446594Z"
}

Respons saat pemrosesan

{
    "created_at": "2025-11-21T08:27:09.933Z",
    "updated_at": "2025-11-21T08:27:10.241Z",
    "task_id": "d4g24nep2jvh04o9uoh0",
    "user_id": "wfi7wGPS4B4PdtTMox5Y",
    "status": "processing",
    "total": 2000,
    "success": 800,
    "failure": 0
}

Respons saat selesai (exported)

{
    "created_at": "2025-11-21T08:27:09.933Z",
    "updated_at": "2025-11-21T08:27:10.241Z",
    "task_id": "d4g24nep2jvh04o9uoh0",
    "user_id": "wfi7wGPS4B4PdtTMox5Y",
    "status": "exported",
    "total": 2000,
    "success": 2000,
    "failure": 0,
    "result_url": "https://example-link-to-results.zip",
    "actual_amount": {
      "amount": "2.000000",
      "currency": "USD"
    }
}

URL permintaan unggah file

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

Parameter permintaan unggah file

Parameter	Deskripsi
`file`	`file`, satu alamat email per baris
`task_type`	`string`, atur ke `email_check`

URL permintaan cek status tugas

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

Parameter permintaan cek status tugas

Parameter	Deskripsi
`task_id`	`string`, ID tugas yang dikembalikan saat pembuatan tugas

Kolom hasil

File hasil ZIP berisi file terpisah per penyedia email. Setiap baris mencakup:

Kolom	Deskripsi
`Email`	Alamat email
`Active`	Apakah email terdaftar di platform (`true` / `false`)
`Provider`	Penyedia email yang terdeteksi: `gmail`, `outlook`, `yahoo`, `mailru`, `icloud`, atau `unsupported`

Penyedia yang didukung

Penyedia	Sub-tugas `task_type`
Gmail	`email_gmail`
Outlook	`email_outlook`
Yahoo	`email_yahoo`
Mail.ru	`email_mailru`
iCloud	`email_icloud`

Ukuran batch minimum: 2.000 alamat email per tugas.

Format respons

Field	Deskripsi
`created_at`	Stempel waktu saat tugas dibuat
`updated_at`	Stempel waktu pembaruan status tugas terakhir
`task_id`	Pengidentifikasi tugas unik
`user_id`	ID pengguna
`status`	`pending` · `processing` · `exported` · `failed` (dikembalikan otomatis)
`total`	Total email yang diajukan
`success`	Email yang berhasil diperiksa
`failure`	Baris yang tidak dapat diproses
`result_url`	URL unduh saat `status` adalah `exported`
`actual_amount`	(Opsional) Jumlah yang benar-benar ditagih, tersedia setelah task diselesaikan
`estimated_amount`	(Respons pembuatan) Perkiraan biaya task; tagihan final diselesaikan saat task selesai

Kode status

Status	Deskripsi
`200`	`free`, Permintaan berhasil (mis. cek status)
`202`	`charge`, Task berhasil dibuat; perkiraan biaya dipotong
`400`	`free`, Permintaan tidak valid: parameter atau format file salah, jenis task tidak didukung, atau entri valid kurang dari batch minimum
`401`	`free`, API key tidak ada atau tidak valid
`402`	`free`, Saldo tidak mencukupi
`404`	`free`, Task tidak ditemukan
`413`	`free`, File yang diunggah terlalu besar
`500`	`free`, Kesalahan server internal, coba lagi nanti