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

application/json
entity_type
enum<string>
wajib

Apakah pihak tersebut adalah individu atau perusahaan.

Opsi yang tersedia:
person,
company
nationality
string
wajib

Kewarganegaraan seseorang, atau negara pendirian perusahaan. Wajib untuk setiap pihak.

Maximum string length: 100
full_name
string

Nama lengkap seseorang. Kirimkan ini, atau first_name dan last_name.

Maximum string length: 255
first_name
string
Maximum string length: 128
last_name
string
Maximum string length: 128
role
enum<string>

Peran yang dipegang oleh pihak terkait. Dapat dipertukarkan dengan roles; saat keduanya dikirim, keduanya digabungkan.

Opsi yang tersedia:
director,
non_executive_director,
secretary,
chairman,
ubo,
shareholder,
representative,
founder,
legal_advisor,
authorized_signatory,
trustee,
beneficiary,
settlor,
protector,
company_officer,
investor,
other
roles
enum<string>[]

Setiap peran yang dipegang pihak tersebut. Seseorang memerlukan setidaknya satu peran (di sini atau di role).

Opsi yang tersedia:
director,
non_executive_director,
secretary,
chairman,
ubo,
shareholder,
representative,
founder,
legal_advisor,
authorized_signatory,
trustee,
beneficiary,
settlor,
protector,
company_officer,
investor,
other
position
string

Jabatan seseorang.

Maximum string length: 128
date_of_birth
string<date> | null
company_name
string

Nama pihak perusahaan. Wajib jika entity_type bernilai company.

Maximum string length: 255
registration_number
string

Nomor registrasi dari pihak perusahaan.

Maximum string length: 100
email
string<email>

Tujuan pengiriman tautan verifikasi. Wajib diisi jika pihak tersebut harus menyelesaikan verifikasi, yang bergantung pada pengaturan peran dan ambang batas kepemilikan alur kerja.

ownership_percent
number | null

Porsi kepemilikan pihak tersebut di dalam perusahaan.

phone_number
string
Maximum string length: 32
custom_fields
object

Kolom tambahan yang ditentukan alur kerja.

skip_verification
boolean
default:false

Minta untuk melewati verifikasi pihak ini. Hanya dipenuhi jika peran pihak tersebut mengizinkan pelewatan dalam pengaturan Pihak Kunci alur kerja.

Respons

Draf berhasil dibuat.

draft_id
string<uuid>
wajib
created_at
string<date-time>
wajib
updated_at
string<date-time>
wajib
party
object
wajib
Terakhir diubah pada 7 November 2026