Langsung ke konten utama
POST
curl
Siapkan satu ZIP berisi setiap file dari sesi Verifikasi Pengguna (KYC) atau Verifikasi Bisnis (KYB): sisi dokumen, swafoto, video liveness, dan dokumen yang diunggah, dalam kualitas asli. ZIP disiapkan di latar belakang. Panggilan ini merespons dengan 202 beserta ekspor. Baca ekspor tersebut dengan Get files export sampai status bernilai READY, lalu unduh download_url.
  • Selama ekspor untuk sesi yang sama masih disiapkan, panggilan mengembalikan ekspor tersebut alih-alih memulai ekspor baru.
  • ZIP dihapus 24 jam setelah siap, dan segera saat sesi dihapus.
  • Sesi yang sudah dihapus tidak dapat diekspor: panggilan mengembalikan 404.
  • Setiap ekspor dicatat di log audit sesi.
  • Kunci API dengan cakupan memerlukan media: read dan decisions: read.

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

sessionId
string<uuid>
wajib

UUID sesi verifikasi (session_id yang dikembalikan oleh POST /v3/session/). Menerima ID sesi Verifikasi Pengguna (KYC) dan Verifikasi Bisnis (KYB). Sesi yang dihapus mengembalikan 404.

Contoh:

"11111111-2222-3333-4444-555555555555"

Respons

Ekspor, sedang disiapkan.

Satu file ZIP berisi setiap file dari sebuah sesi, dalam kualitas asli.

export_id
string<uuid>
wajib

ID ekspor. Teruskan ke GET /v3/session/{sessionId}/files-export/{exportId}/.

session_id
string<uuid>
wajib

Sesi asal file-file tersebut.

status
enum<string>
wajib

PENDING dan PROCESSING saat ZIP sedang disiapkan, READY setelah dapat diunduh, FAILED ketika tidak dapat disiapkan (minta ekspor baru), EXPIRED setelah ZIP dihapus.

Opsi yang tersedia:
PENDING,
PROCESSING,
READY,
FAILED,
EXPIRED
file_count
integer | null
wajib

File di dalam ZIP. Diatur hanya ketika status bernilai READY.

size_bytes
integer<int64> | null
wajib

Ukuran ZIP dalam bita. Diatur hanya saat status adalah READY.

download_url
string<uri> | null
wajib

URL ZIP yang ditandatangani, valid untuk waktu singkat. Diatur hanya saat status adalah READY; baca ekspor lagi untuk mendapatkan yang baru.

expires_at
string<date-time> | null
wajib

Waktu ketika ZIP dihapus, 24 jam setelah siap. Hanya diatur selama status bernilai READY.

error
string | null
wajib

Alasan mengapa ekspor gagal, saat status adalah FAILED.

created_at
string<date-time>
wajib

Waktu ketika ekspor diminta.

completed_at
string<date-time> | null
wajib

Waktu ketika ZIP siap atau ekspor gagal.

Terakhir diubah pada 7 November 2026