Langsung ke konten utama
GET
curl

Ikhtisar

Mengembalikan satu entitas Bisnis yang dikenali melalui vendor_data.

Kapan digunakan

  • Pemeriksaan status verifikasi terkini suatu bisnis. Peta features memberikan status terbaru dari setiap fitur KYB sekaligus.
  • Tampilan detail di antarmuka admin Anda sendiri.
  • Penilaian risiko menggunakan penghitung agregat dan status fitur.

Catatan

  • vendor_data di URL bersifat peka huruf besar-kecil.
  • Mengembalikan 404 jika tidak ada bisnis dengan vendor_data tersebut.
  • Penghitung agregat (session_count, approved_count, declined_count, in_review_count) diperbarui secara real-time saat sesi Verifikasi Bisnis (KYB) selesai.
  • Kolom yang berasal dari registri (legal_name, registration_number, country_code) mencerminkan sesi Verifikasi Bisnis (KYB) terbaru yang disetujui.

Izin

Peran harus memberikan izin read:businesses.

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

vendor_data
string
wajib

Pengidentifikasi unik Anda untuk bisnis — string bentuk bebas (BUKAN UUID), dicocokkan persis seperti yang dikirim.

Respons

Detail lengkap bisnis termasuk metadata dan agregasi data sesi.

Detail bisnis lengkap. Memperluas BusinessListItem dengan metadata dan updated_at.

didit_internal_id
string<uuid>

UUID internal yang stabil dari Didit untuk bisnis ini.

vendor_data
string | null

Pengidentifikasi unik Anda untuk bisnis ini (diteruskan saat membuat sesi). Nilai ini dapat berupa null jika tidak ada pengidentifikasi vendor yang diberikan.

display_name
string | null

Nama tampilan kustom yang Anda tetapkan

Nama resmi menurut hukum dari registri atau entri manual

registration_number
string | null

Nomor registrasi atau nomor pendirian perusahaan

country_code
string | null

Negara pendirian (ISO 3166-1 alpha-2, misalnya GB, US).

effective_name
string | null

Nama terbaik yang tersedia: display_name jika disetel, selain itu legal_name

status
enum<string>

Status siklus hidup rekaman bisnis (BUKAN status sesi). ACTIVE adalah default, FLAGGED menandainya untuk perhatian manual, BLOCKED mencegah sesi baru untuk vendor_data ini.

Opsi yang tersedia:
ACTIVE,
FLAGGED,
BLOCKED
session_count
integer

Jumlah total sesi verifikasi untuk bisnis ini

approved_count
integer

Jumlah sesi yang disetujui

declined_count
integer

Jumlah sesi yang ditolak

in_review_count
integer

Jumlah sesi dalam peninjauan

features
object

Status per-fitur agregat di semua sesi KYB bisnis ini. Saat ini satu-satunya kunci adalah KYB (status pemeriksaan perusahaan di registri). Nilai yang memungkinkan: Approved, Declined, In Review, Not Finished, Resub Requested.

features_list
object[]

Data yang sama dengan features, sebagai array berurutan dari objek {feature, status}.

last_session_at
string<date-time> | null

Cap waktu sesi terbaru

first_session_at
string<date-time> | null

Cap waktu sesi pertama

last_activity_at
string<date-time> | null

Cap waktu aktivitas terbaru (perubahan status, pembaruan sesi, dll.)

tags
object[]

Tag yang ditetapkan untuk bisnis ini

created_at
string<date-time>
metadata
object

JSON metadata kustom yang Anda lampirkan ke bisnis ini. Default adalah {}.

updated_at
string<date-time>
Terakhir diubah pada 7 November 2026