Langsung ke konten utama
POST
Python

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 dari sesi Verifikasi Bisnis (KYB). UUID ini harus dimiliki oleh aplikasi yang terkait dengan kunci API.

Contoh:

"33333333-4444-5555-6666-777777777777"

Parameter Query

node_id
string

Node alur kerja dari langkah KYB. Hanya diperlukan jika alur kerja memiliki lebih dari satu node KYB; secara default Didit menggunakan node milik sesi itu sendiri.

Body

multipart/form-data
documents
file[]
wajib

File yang akan diunggah: JPG, JPEG, PNG, TIFF, WEBP, PDF, atau arsip ZIP yang berisi file-file tersebut. PDF hingga 50 MB, foto hingga 6 MB sebelum kompresi.

document_passwords
string[]

Satu entri per file di documents, dalam urutan yang sama: kata sandi PDF yang diproteksi, kosong untuk file lainnya.

document_group
enum<string>

Grup dokumen wajib yang dipenuhi oleh unggahan ini.

Opsi yang tersedia:
LEGAL_PRESENCE,
COMPANY_DETAILS,
OWNERSHIP_STRUCTURE,
REPRESENTATIVES_AUTHORIZATION
locale
string

Lokal yang digunakan untuk menerjemahkan respons langkah berikutnya.

Maximum string length: 10

Respons

Dokumen diproses. Saat setiap grup yang diwajibkan terpenuhi, sesi berlanjut dan next_step menyebutkan langkah berikutnya; jika tidak, sesi tetap berada pada langkah Dokumen serta document_groups dan document_answer menyatakan apa yang masih kurang.

valid
boolean
next_step
string | null

Langkah yang sedang dijalani sesi setelah pengunggahan.

kyb_status
string

Status pemeriksaan perusahaan.

document_answer
object

Hasil per dokumen yang diunggah dan sisa unggahan.

Terakhir diubah pada 7 November 2026