Referensi

EmailCheckPro Referensi API

Setiap endpoint berbagi satu kunci API dan satu saldo.

Item	Nilai
URL dasar	https://emailcheckpro.com
Header autentikasi	X-API-Key: sk_your_api_key
Amplop respons	{ code, msg, data }

Harga tidak dicantumkan di sini; setiap produk ditagihkan per pemeriksaan yang berhasil. Lihat harga

Autentikasi

Gunakan kunci API yang dibuat di Pengaturan dan kirimkan bersama setiap permintaan.

Header autentikasi

X-API-Key: sk_your_api_key

Jaga kerahasiaan kunci API AndaSelalu panggil endpoint ini dari server Anda. Siapa pun yang memegang kunci dapat menghabiskan saldo Anda.

Pemeriksaan sinkron

POST/api/v1/checkPOST/api/v1/batch-check

Kirim satu alamat email, atau hingga 100 dalam satu permintaan, dan baca hasilnya di respons yang sama. Tanpa polling, tanpa callback. Hasil yang tidak dapat ditentukan mengembalikan 422 dengan kode 42200 dan tidak ditagihkan. Permintaan multi mempertahankan urutan input, menagih setiap pengenal secara terpisah, dan memiliki waktu 300 detik untuk selesai — jika tidak, seluruh permintaan gagal dan setiap tagihan dikembalikan.

Parameter

Kolom	Tipe	Deskripsi
`service_type`	string	Kode produk, salah satu produk yang tercantum di bawah.
`identifier`	string	Pemeriksaan tunggal: satu alamat email. Server menormalkannya.
`identifiers`	string[]	Pemeriksaan multi: 1 hingga 100 alamat email. Respons mempertahankan urutan ini.

Produk dalam grup ini

Pemeriksaan Keterkiriman EmailemailPastikan apakah alamat email masih dapat menerima email — berfungsi di domain apa pun, dari Gmail hingga domain milik perusahaan.Halaman produk
Pemeriksaan Avatar Emailemail_avatarStatus keterkiriman plus URL avatar di balik alamat, untuk Gmail, Yandex, dan Mail.ru.Halaman produk

Pemeriksaan Keterkiriman Email

emailemail

Pastikan apakah alamat email masih dapat menerima email — berfungsi di domain apa pun, dari Gmail hingga domain milik perusahaan.

Pemeriksaan tunggal

POST/api/v1/check

Permintaan

curl -X POST "https://emailcheckpro.com/api/v1/check" \
  -H "X-API-Key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "service_type": "email", "identifier": "name@gmail.com" }'

{
  "code": 0,
  "msg": "ok",
  "data": {
    "service_type": "email",
    "identifier": "name@gmail.com",
    "registered": true
  }
}

Field respons

Kolom	Tipe	Deskripsi
`registered`	boolean	Apakah alamat dapat dikirimi — apakah dapat menerima email.

Pemeriksaan multi

POST/api/v1/batch-check

Permintaan

curl -X POST "https://emailcheckpro.com/api/v1/batch-check" \
  -H "X-API-Key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "service_type": "email", "identifiers": ["name@gmail.com", "unknown@gmail.com", "not-an-email"] }'

Respons

{
  "code": 0,
  "msg": "ok",
  "data": {
    "service_type": "email",
    "total": 3,
    "succeeded": 2,
    "failed": 1,
    "results": [
      {
        "identifier": "name@gmail.com",
        "exists": true,
        "registered": true
      },
      {
        "identifier": "unknown@gmail.com",
        "exists": true,
        "registered": false
      },
      {
        "identifier": "not-an-email",
        "exists": false
      }
    ]
  }
}

Field respons

Kolom	Tipe	Deskripsi
`exists`	boolean	Apakah email ini menghasilkan hasil. false berarti formatnya tidak valid, hasilnya tidak dapat ditentukan, atau pemeriksaan gagal; jika false, tidak ada kolom di bawah ini yang disertakan.
`registered`	boolean	Apakah email dapat dikirimi, yaitu apakah alamat tersebut dapat menerima email. Hanya ada jika exists bernilai true, dengan arti yang sama seperti pemeriksaan tunggal.

Pemeriksaan Avatar Email

email_avataremail

Status keterkiriman plus URL avatar di balik alamat, untuk Gmail, Yandex, dan Mail.ru.

Pemeriksaan tunggal

POST/api/v1/check

Permintaan

curl -X POST "https://emailcheckpro.com/api/v1/check" \
  -H "X-API-Key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "service_type": "email_avatar", "identifier": "name@gmail.com" }'

{
  "code": 0,
  "msg": "ok",
  "data": {
    "service_type": "email_avatar",
    "identifier": "name@gmail.com",
    "registered": true,
    "avatar": true,
    "avatar_url": "https://lh3.googleusercontent.com/a-/example"
  }
}

Field respons

Kolom	Tipe	Deskripsi
`registered`	boolean	Apakah alamat dapat dikirimi di penyedia tersebut — apakah dapat menerima email.
`avatar`	boolean	Apakah avatar sudah diatur.
`avatar_url`	string	URL avatar jika ada; bisa kosong meskipun avatar bernilai true.

Pemeriksaan multi

POST/api/v1/batch-check

Permintaan

curl -X POST "https://emailcheckpro.com/api/v1/batch-check" \
  -H "X-API-Key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "service_type": "email_avatar", "identifiers": ["name@gmail.com", "unknown@gmail.com", "not-an-email"] }'

Respons

{
  "code": 0,
  "msg": "ok",
  "data": {
    "service_type": "email_avatar",
    "total": 3,
    "succeeded": 2,
    "failed": 1,
    "results": [
      {
        "identifier": "name@gmail.com",
        "exists": true,
        "registered": true,
        "avatar": true,
        "avatar_url": "https://lh3.googleusercontent.com/a-/example"
      },
      {
        "identifier": "unknown@gmail.com",
        "exists": true,
        "registered": false,
        "avatar": false,
        "avatar_url": ""
      },
      {
        "identifier": "not-an-email",
        "exists": false
      }
    ]
  }
}

Field respons

Kolom	Tipe	Deskripsi
`exists`	boolean	Apakah email ini menghasilkan hasil. false berarti formatnya tidak valid, hasilnya tidak dapat ditentukan, atau pemeriksaan gagal; jika false, tidak ada kolom di bawah ini yang disertakan.
`registered`	boolean	Apakah email dapat dikirimi, yaitu apakah alamat tersebut dapat menerima email. Hanya ada jika exists bernilai true, dengan arti yang sama seperti pemeriksaan tunggal.
`avatar`	boolean	Apakah avatar sudah diatur.
`avatar_url`	string	URL avatar jika ada; bisa kosong meskipun avatar bernilai true.

Pemeriksaan asinkron

POST/api/v1/bulk-tasksGET/api/v1/bulk-tasks/{id}

Unggah file dan langsung dapatkan ID tugas, lalu periksa ID tersebut sampai berhasil. Respons yang berhasil membawa result_url, tautan unduhan hasil. Hanya ada dua tindakan: kirim dan periksa. Lakukan polling tidak lebih sering dari sekali setiap 30 detik.

Parameter

Kolom	Tipe	Deskripsi
`service_type`	string	Kode produk massal, salah satu produk yang tercantum di bawah.
`country`	string	Tidak diperlukan untuk tugas email, jadi tidak perlu dikirim. Jika Anda tetap mengirimkannya, field ini akan diabaikan.
`file`	file	File `.txt` atau `.csv` dengan satu pengenal per baris, hingga `max_file_bytes` (default 20MB).
`Idempotency-Key`	header	Opsional, hingga 128 karakter. Mengirim ulang kunci yang sama mengembalikan tugas asli alih-alih membuat tugas kedua.

Produk dalam grup ini

Pemeriksaan Keterkiriman Email Massalemail_batchUnggah seluruh file alamat, ketahui mana yang dapat menerima email, dan unduh hasilnya setelah selesai.Halaman produk
Pemeriksaan Avatar Email Massalemail_avatar_batchUnggah seluruh file alamat Gmail, Yandex, atau Mail.ru: ketahui mana yang dapat dikirimi dan dapatkan avatar masing-masing.Halaman produk

Pemeriksaan Keterkiriman Email Massal

email_batchemail1.000–500.000 per tugas

Unggah seluruh file alamat, ketahui mana yang dapat menerima email, dan unduh hasilnya setelah selesai.

Kirim tugas

POST/api/v1/bulk-tasks

Permintaan

curl -X POST "https://emailcheckpro.com/api/v1/bulk-tasks" \
  -H "X-API-Key: sk_your_api_key" \
  -F service_type=email_batch \
  -F file=@emails.txt

Respons

{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "email_batch",
    "status": "processing",
    "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"
  }
}

Periksa tugas

GET/api/v1/bulk-tasks/{id}

Permintaan

curl "https://emailcheckpro.com/api/v1/bulk-tasks/3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13" \
  -H "X-API-Key: sk_your_api_key"

Respons

{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "email_batch",
    "status": "success",
    "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"
  }
}

Kolom hasil

Kolom	contoh:	Deskripsi
`identifier`	alex.kim@example.com	Alamat email yang dikirim, dalam huruf kecil.
`activated`	true	Apakah alamat dapat menerima email: true (dapat dijangkau) atau false (tidak dapat dijangkau).

Pemeriksaan Avatar Email Massal

email_avatar_batchemail1.000–500.000 per tugas

Unggah seluruh file alamat Gmail, Yandex, atau Mail.ru: ketahui mana yang dapat dikirimi dan dapatkan avatar masing-masing.

Kirim tugas

POST/api/v1/bulk-tasks

Permintaan

curl -X POST "https://emailcheckpro.com/api/v1/bulk-tasks" \
  -H "X-API-Key: sk_your_api_key" \
  -F service_type=email_avatar_batch \
  -F file=@emails.txt

Respons

{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "email_avatar_batch",
    "status": "processing",
    "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"
  }
}

Periksa tugas

GET/api/v1/bulk-tasks/{id}

Permintaan

curl "https://emailcheckpro.com/api/v1/bulk-tasks/3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13" \
  -H "X-API-Key: sk_your_api_key"

Respons

{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "3f9c2a7d8e4b4c1a9f0e6b2d5c8a7e13",
    "product": "email_avatar_batch",
    "status": "success",
    "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"
  }
}

Kolom hasil

Kolom	contoh:	Deskripsi
`identifier`	alex.kim@gmail.com	Alamat yang dikirim, dalam huruf kecil.
`activated`	true	Apakah alamat dapat dikirimi di penyedia tersebut — apakah dapat menerima email: true atau false. Jika tidak true, setiap kolom lain di baris tersebut dibiarkan kosong.
`avatar`	true	Apakah avatar sudah diatur: true atau false. avatar_url tetap bisa kosong jika gambar tidak tersedia.
`avatar_url`	https://lh3.googleusercontent.com/a/example	URL avatar; kosong jika tidak ada URL yang tersedia.

Saldo

GET/api/v1/balance

Baca saldo akun saat ini dalam mikro USD. Hanya-baca: tidak membuat catatan pemeriksaan dan tidak menagih apa pun.

Saldo

GET/api/v1/balance

Permintaan

curl "https://emailcheckpro.com/api/v1/balance" \
  -H "X-API-Key: sk_your_api_key"

Respons

{
  "code": 0,
  "msg": "ok",
  "data": {
    "balance_micros": 12500000
  }
}

Konkurensi, batas waktu, dan perilaku percobaan ulang

Pemeriksaan keterkiriman email bersifat sinkron. Gunakan code yang dikembalikan untuk memutuskan apakah akan menerima hasil atau mencoba lagi.

Kolom	Deskripsi
`5 permintaan berjalan per pengguna`	Pemeriksaan tunggal dan multi berbagi batas ini, dan permintaan multi dihitung sebagai satu permintaan berapa pun jumlah email di dalamnya. Selain itu, hanya satu pemeriksaan multi per akun yang berjalan pada satu waktu; pemeriksaan kedua ditolak sampai yang pertama selesai. Mencapai salah satu batas langsung mengembalikan kode 42901 tanpa tagihan, beserta header Retry-After — kirim ulang setelah permintaan yang sedang berjalan selesai.
`60 dtk tunggal, 300 dtk multi`	Melebihi batas waktu mengembalikan kode 50400 tanpa tagihan. Pemeriksaan multi yang melebihi batas waktu gagal secara keseluruhan — tidak ada hasil parsial, dan seluruh jumlah dikembalikan.
`Pemeriksaan multi menerima hingga 100 email`	Hasil mempertahankan urutan dan jumlah seperti yang dikirim. Satu pemeriksaan multi per akun berjalan dalam satu waktu; kirim batch berikutnya setelah batch sebelumnya kembali.

Kode error

Kode	Deskripsi
`40000`	Tipe layanan tidak didukung atau field permintaan saling bertentangan
`40001`	Body JSON tidak valid
`40002`	Email tidak valid
`40100`	Kunci API tidak ada atau tidak valid
`40200`	Saldo tidak mencukupi
`42200`	Email tidak dapat ditentukan saat ini. Tidak ada data yang dikembalikan dan permintaan tidak ditagihkan
`42900`	Kuota penggunaan habis, atau terlalu banyak pesanan yang belum selesai
`42901`	Kelima slot permintaan yang sedang berjalan sudah terisi, atau pemeriksaan multi sudah berjalan di akun ini; kirim setelah permintaan yang sedang berjalan selesai. Permintaan yang ditolak tidak ditagihkan dan menyertakan header Retry-After
`50303`	Layanan sedang mencapai kapasitas penuh; tidak ditagihkan. Tunggu sesuai detik Retry-After lalu kirim ulang permintaan yang sama
`50400`	Pemeriksaan tidak selesai dalam batas waktunya dan tidak ditagihkan; coba lagi. Batas waktu batch membuat seluruh batch gagal dan seluruh jumlah dikembalikan
`50300`	Pemeliharaan layanan validasi