Cek status
GET /emails/{id}
Ambil id dari respons 202 saat kirim, lalu panggil endpoint ini untuk melihat status pengiriman.
URL
| Field | Value |
|---|---|
| Method | GET |
| URL | https://api.mailnation.id/emails/{id} |
{id} = nilai id dari POST /emails.
GET https://api.mailnation.id/emails/01JEXAMPLEHeader
| Header | Wajib | Keterangan |
|---|---|---|
Authorization | ya | Basic (SMTP) atau Bearer (JWT) — sama seperti kirim |
Idempotency-Key tidak dipakai di GET.
Authorization: Basic <base64>Body
Tidak ada. GET tanpa body.
Contoh
curl -u 'SMTP_USERNAME:SMTP_PASSWORD' \
https://api.mailnation.id/emails/01JEXAMPLEPesan milik akun lain → 404.
Respons
HTTP 200
| Field | Keterangan |
|---|---|
status | queued | delivered | partial | failed |
recipients[] | Status per alamat, kode SMTP, delivered_at / bounced_at |
billing_status | Status billing pesan |
request_id | ID request |
status | Artinya |
|---|---|
queued | Masih ada penerima yang belum terminal |
delivered | Semua penerima delivered |
partial | Campuran delivered dan gagal |
failed | Semua penerima gagal / bounce |
{
"id": "01JEXAMPLE",
"status": "delivered",
"source": "api",
"from": "noreply@domain-anda.id",
"subject": "Kode OTP",
"recipients": [
{
"email": "user@gmail.com",
"status": "delivered",
"attempt_count": 1,
"delivered_at": "2026-08-31T07:00:00Z"
}
],
"request_id": "req_01JEXAMPLE"
}