Langsung ke konten utama
GET
curl

Ikhtisar

Mengembalikan penghapusan sesi massal yang dimulai oleh Hapus Sesi Massal: statusnya, berapa banyak sesi yang sudah diproses, dan berapa banyak sesi yang berakhir pada setiap hasil. Ketika lebih dari 20 sesi KYC cocok dengan penghapusan massal, dipilih melalui session_numbers atau dengan delete_all, permintaan mengembalikan 202 dengan job PENDING, dan sesi-sesi dihapus di latar belakang. Lakukan polling pada endpoint ini setiap beberapa detik hingga status menjadi COMPLETED atau FAILED. Setiap sesi yang dihapus oleh job dihapus dengan cara yang sama seperti melalui Hapus Sesi: sesi itu, setiap percobaan verifikasi yang dimilikinya, dan semua berkas tersimpannya dihapus, dan URL media-nya berhenti dapat diakses. Penghapusan bersifat permanen dan tidak dapat dibatalkan. Job hanya melaporkan jumlah. Job tidak pernah mencantumkan sesi mana saja yang telah dihapusnya.

Status job

Job delete_all hanya menghapus sesi yang dibuat sebelum permintaan. Sesi yang dimulai selama job berjalan tidak dihapus.

Jumlah hasil

deleted_child_verifications menghitung verifikasi yang dibuat oleh verifikasi bisnis yang dihapus dan ikut terhapus bersamanya. Nilainya selalu 0 untuk job yang dimulai oleh Hapus Sesi Massal, yang hanya menghapus sesi KYC.

Izin

Setiap kunci API aktif milik aplikasi dapat memanggil endpoint ini. Job hanya terlihat oleh aplikasi yang membuatnya; job_id lain mengembalikan 404.

Terkait

Otorisasi

x-api-key
string
header
wajib

Kunci API aplikasi Anda, dari Developers -> API keys di Business Console. Kunci utama memiliki akses penuh. Kunci bernama dapat diberi cakupan: none, read, atau write per sumber daya, dibatasi pada beberapa alur kerja atau pada sesi yang disetujui, pada daftar alamat IP, dan pada tanggal kedaluwarsa. 401 berarti kuncinya salah, dicabut, atau kedaluwarsa; 403 berarti tidak ada kunci yang dikirimkan, kunci tidak memiliki akses ke sumber daya atau tindakan ini, atau permintaan datang dari alamat di luar daftar IP-nya; 404 pada rute sesi berarti sesi berada di luar alur kerja atau status kunci tersebut. Kunci tanpa akses media menerima URL gambar, video, dan PDF sebagai null, dan kunci tanpa izin tulis sesi menerima tautan sesi dan token sebagai null. Lihat https://docs.didit.me/console/api-keys.

Parameter Path

job_id
string<uuid>
wajib

job_id yang dikembalikan bersama 202 dari POST /v3/sessions/delete/.

Respons

Pekerjaan tersebut.

Penghapusan sesi massal yang berjalan di latar belakang: progres dan jumlah per hasil, tidak pernah menampilkan sesi mana saja yang dihapusnya.

job_id
string<uuid>

Lakukan polling GET /v3/sessions/delete/{job_id}/ dengan id ini.

status
enum<string>

PENDING: diterima, belum dimulai. PROCESSING: sedang menghapus; processed dan outcomes sedang diperbarui. COMPLETED: setiap sesi yang dipilih telah ditangani. FAILED: pekerjaan berhenti lebih awal; lihat error.

Opsi yang tersedia:
PENDING,
PROCESSING,
COMPLETED,
FAILED
total
integer

Sesi yang dipilih saat penghapusan diminta.

processed
integer

Sesi yang telah selesai diproses oleh pekerjaan sejauh ini.

outcomes
object

Berapa banyak sesi yang berakhir di setiap hasil. Setiap kunci selalu ada.

deleted_child_verifications
integer

Verifikasi yang dibuat oleh verifikasi bisnis yang dihapus, yang dihapus bersamanya. Selalu 0 untuk pekerjaan yang dimulai oleh POST /v3/sessions/delete/, yang hanya menghapus sesi KYC.

error
string | null

null kecuali jika status bernilai FAILED; kemudian alasan mengapa penghapusan berhenti. Sesi yang belum tercapai oleh tugas masih tetap ada: ulangi permintaan untuk menghapusnya.

created_at
string<date-time>

Waktu ketika penghapusan diminta.

completed_at
string<date-time> | null

Waktu pekerjaan selesai; null selama pekerjaan berjalan.

Terakhir diubah pada 7 November 2026