API Daftar Sesi: Filter Sesi Verifikasi KYC & KYB

curl

curl -s 'https://verification.didit.me/v3/sessions/?status=Approved,In%20Review&date_from=2026-06-01&limit=20' \
  -H 'x-api-key: YOUR_API_KEY'

ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()

iter := client.Sessions.ListAutoPaging(ctx, didit.SessionsListParams{})
for iter.Next() {
	fmt.Printf("%+v\n", iter.Current())
}
if err := iter.Err(); err != nil {
	log.Fatal(err)
}

using System;
using System.Text.Json;
using Didit;

// Reads DIDIT_API_KEY.
using var client = new DiditClient();

await foreach (var item in await client.Sessions.ListAsync())
{
    Console.WriteLine(JsonSerializer.Serialize(item));
}

{
  "count": 2,
  "next": null,
  "previous": null,
  "results": [
    {
      "session_id": "5b3720ed-d429-42ef-b67f-37ea805f48ee",
      "session_kind": "user",
      "session_number": 720,
      "session_url": "https://verify.didit.me/session/CuXoBYCYVO5Y",
      "portrait_image": "https://<media-host>/portraits/5b3720ed.jpg?X-Amz-Expires=3600&X-Amz-Signature=...",
      "document_type": "Passport",
      "full_name": "Jane Marie Doe",
      "country": "ESP",
      "status": "Approved",
      "vendor_data": "your-user-id-123",
      "didit_internal_id": "d9e78474-6c8d-4f2a-bb90-6f5c2f3a1147",
      "created_at": "2026-06-09T12:26:54.328364Z",
      "features": [
        {
          "feature": "ID_VERIFICATION",
          "status": "Approved"
        },
        {
          "feature": "LIVENESS",
          "status": "Approved"
        },
        {
          "feature": "FACE_MATCH",
          "status": "Approved"
        },
        {
          "feature": "AML",
          "status": "Approved"
        },
        {
          "feature": "IP_ANALYSIS",
          "status": "Approved"
        }
      ],
      "phone_number": {
        "number": "+14155552671",
        "is_verified": true
      },
      "email_address": {
        "email": "jane@example.com",
        "is_verified": true
      },
      "additional_details": {
        "aml": {
          "total_hits": 0,
          "entity_type": "person",
          "is_adverse_media_fetched": false
        },
        "liveness": {
          "method": "PASSIVE",
          "score": 0.98
        },
        "face_match": {
          "score": 0.95
        }
      }
    },
    {
      "session_id": "038ad62f-5ebd-46c2-afe9-4b2956bf687f",
      "session_kind": "user",
      "session_number": 719,
      "session_url": "https://verify.didit.me/session/7RGKiO6ioGH6",
      "portrait_image": null,
      "document_type": null,
      "full_name": null,
      "country": null,
      "status": "Not Started",
      "vendor_data": "your-user-id-124",
      "didit_internal_id": "eb4e679d-ca4b-461f-9685-687bac29ebdb",
      "created_at": "2026-06-09T08:02:23.343053Z",
      "features": [
        {
          "feature": "ID_VERIFICATION",
          "status": "Not Finished"
        },
        {
          "feature": "LIVENESS",
          "status": "Not Finished"
        },
        {
          "feature": "FACE_MATCH",
          "status": "Not Finished"
        },
        {
          "feature": "AML",
          "status": "Not Finished"
        },
        {
          "feature": "IP_ANALYSIS",
          "status": "Not Finished"
        }
      ],
      "phone_number": null,
      "email_address": null,
      "additional_details": null
    }
  ]
}

GET

sessions

curl

curl -s 'https://verification.didit.me/v3/sessions/?status=Approved,In%20Review&date_from=2026-06-01&limit=20' \
  -H 'x-api-key: YOUR_API_KEY'

ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()

iter := client.Sessions.ListAutoPaging(ctx, didit.SessionsListParams{})
for iter.Next() {
	fmt.Printf("%+v\n", iter.Current())
}
if err := iter.Err(); err != nil {
	log.Fatal(err)
}

using System;
using System.Text.Json;
using Didit;

// Reads DIDIT_API_KEY.
using var client = new DiditClient();

await foreach (var item in await client.Sessions.ListAsync())
{
    Console.WriteLine(JsonSerializer.Serialize(item));
}

{
  "count": 2,
  "next": null,
  "previous": null,
  "results": [
    {
      "session_id": "5b3720ed-d429-42ef-b67f-37ea805f48ee",
      "session_kind": "user",
      "session_number": 720,
      "session_url": "https://verify.didit.me/session/CuXoBYCYVO5Y",
      "portrait_image": "https://<media-host>/portraits/5b3720ed.jpg?X-Amz-Expires=3600&X-Amz-Signature=...",
      "document_type": "Passport",
      "full_name": "Jane Marie Doe",
      "country": "ESP",
      "status": "Approved",
      "vendor_data": "your-user-id-123",
      "didit_internal_id": "d9e78474-6c8d-4f2a-bb90-6f5c2f3a1147",
      "created_at": "2026-06-09T12:26:54.328364Z",
      "features": [
        {
          "feature": "ID_VERIFICATION",
          "status": "Approved"
        },
        {
          "feature": "LIVENESS",
          "status": "Approved"
        },
        {
          "feature": "FACE_MATCH",
          "status": "Approved"
        },
        {
          "feature": "AML",
          "status": "Approved"
        },
        {
          "feature": "IP_ANALYSIS",
          "status": "Approved"
        }
      ],
      "phone_number": {
        "number": "+14155552671",
        "is_verified": true
      },
      "email_address": {
        "email": "jane@example.com",
        "is_verified": true
      },
      "additional_details": {
        "aml": {
          "total_hits": 0,
          "entity_type": "person",
          "is_adverse_media_fetched": false
        },
        "liveness": {
          "method": "PASSIVE",
          "score": 0.98
        },
        "face_match": {
          "score": 0.95
        }
      }
    },
    {
      "session_id": "038ad62f-5ebd-46c2-afe9-4b2956bf687f",
      "session_kind": "user",
      "session_number": 719,
      "session_url": "https://verify.didit.me/session/7RGKiO6ioGH6",
      "portrait_image": null,
      "document_type": null,
      "full_name": null,
      "country": null,
      "status": "Not Started",
      "vendor_data": "your-user-id-124",
      "didit_internal_id": "eb4e679d-ca4b-461f-9685-687bac29ebdb",
      "created_at": "2026-06-09T08:02:23.343053Z",
      "features": [
        {
          "feature": "ID_VERIFICATION",
          "status": "Not Finished"
        },
        {
          "feature": "LIVENESS",
          "status": "Not Finished"
        },
        {
          "feature": "FACE_MATCH",
          "status": "Not Finished"
        },
        {
          "feature": "AML",
          "status": "Not Finished"
        },
        {
          "feature": "IP_ANALYSIS",
          "status": "Not Finished"
        }
      ],
      "phone_number": null,
      "email_address": null,
      "additional_details": null
    }
  ]
}

Filter jenis sesi

Gunakan parameter query session_kind untuk memilih jenis sesi yang dikembalikan:

Nilai	Mengembalikan
`user` (bawaan)	Hanya sesi Verifikasi Pengguna (KYC). Perilaku yang kompatibel dengan versi sebelumnya. Hilangkan `session_kind` untuk mendapatkan perilaku ini.
`business`	Hanya sesi Verifikasi Bisnis (KYB).
`all`	Sesi Verifikasi Pengguna dan Verifikasi Bisnis, digabungkan.

Setiap baris dalam respons menyertakan session_kind: "user" | "business" agar klien Anda dapat menentukan bentuk data per baris.

Filter umum

Filter ini berlaku untuk kedua jenis (filter khusus pengguna diabaikan saat session_kind=business, dan sebaliknya):

Parameter query	Deskripsi
`session_kind`	`user`, `business`, atau `all`. Bawaan `user`.
`vendor_data`	Pencocokan persis dengan pengidentifikasi Anda.
`status`	Satu atau beberapa status, dipisahkan koma, ditulis persis seperti yang dikembalikan API: `Approved`, `Declined`, `In Review`, dan seterusnya (lihat Status verifikasi).
`workflow_id`	Filter berdasarkan alur kerja yang digunakan.
`country`	Filter kode negara (pengguna: `issuing_states`, bisnis: `country_code`).
`date_from`, `date_to`	Rentang tanggal pembuatan (ISO 8601).
`tags`	ID tag, dipisahkan koma. Mengembalikan sesi yang memiliki salah satu tag tersebut.
`decided_from`, `decided_to`	Tanggal dan waktu ISO 8601. Mengembalikan sesi yang statusnya terakhir berubah dalam rentang tersebut (batas awal inklusif dan batas akhir eksklusif). Filter ini memakai waktu perubahan status terakhir, bukan waktu pembuatan.
`search`	Referensi lengkap yang ditampilkan, seperti `S-0001` atau `B-0001`, hanya cocok dengan nomor dan jenis sesi tersebut, dengan mengabaikan angka nol di depan dan perbedaan huruf besar atau kecil. Input lain mencari di kolom nama, kontak, dokumen, nomor registrasi, dan `vendor_data` yang sudah ada.

Contoh

Daftar sesi Verifikasi Pengguna (KYC) (bawaan)
Daftar sesi Verifikasi Bisnis (KYB)
Daftar kedua jenis

curl -G https://verification.didit.me/v3/sessions/ \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "vendor_data=user-42"

Respons (terpotong):

{
  "count": 3,
  "next": null,
  "previous": null,
  "results": [
    {
      "session_id": "...",
      "session_kind": "user",
      "session_number": 1024,
      "session_url": "...",
      "portrait_image": "...",
      "document_type": "Passport",
      "full_name": "John Doe",
      "country": "GBR",
      "status": "Approved",
      "vendor_data": "user-42",
      "didit_internal_id": "...",
      "created_at": "2026-04-10T09:00:00Z",
      "features": "ID_VERIFICATION,LIVENESS,FACE_MATCH,AML",
      "phone_number": "+14155550123",
      "email_address": "jane@example.com",
      "additional_details": null
    }
  ]
}

curl -G https://verification.didit.me/v3/sessions/ \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "session_kind=business" \
  --data-urlencode "status=Approved"

Respons (terpotong):

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "session_id": "...",
      "session_kind": "business",
      "session_number": 89,
      "status": "Approved",
      "vendor_data": "biz-acme-001",
      "created_at": "2026-04-01T09:00:00Z",
      "workflow_id": "wf_kyb_standard",
      "workflow_type": "business",
      "workflow_label": "Standard KYB",
      "company_name": "Acme Corporation Limited",
      "registration_number": "12345678",
      "country": "GBR"
    }
  ]
}

curl -G https://verification.didit.me/v3/sessions/ \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "session_kind=all" \
  --data-urlencode "date_from=2026-04-01T00:00:00Z"

Mengembalikan baris Verifikasi Pengguna dan Verifikasi Bisnis dalam satu array results. Konsumen harus menentukan bentuk data per baris berdasarkan session_kind.

Mode all menggabungkan hasil, bukan menyisipkannya berdasarkan stempel waktu. Untuk penelusuran campuran dengan volume tinggi, panggil setiap jenis secara terpisah lalu gabungkan di sisi klien.

Bentuk baris berbeda menurut jenis

Baris Verifikasi Pengguna (KYC) mencakup: portrait_image, document_type, full_name, country (negara penerbit), phone_number, email_address, dan beberapa kolom peninjauan: assignee (peninjau Console yang memegang sesi, atau null), waiting_since dan sla_due_at (hanya diisi saat sesi berstatus In Review), top_warnings (peringatan paling penting, masing-masing dengan risk, feature, log_type, dan short_description), serta warnings_count. Baris Verifikasi Bisnis (KYB) mencakup: workflow_type, workflow_label, company_name, registration_number, country (negara pendirian). Keduanya memuat: session_id, session_kind, session_number, status, vendor_data, created_at. Lihat Ikhtisar sesi untuk matriks fitur lengkap.

Paginasi

Paginasi menggunakan limit (bawaan 50) dan offset (bawaan 0), dengan URL absolut next dan previous dalam respons. Kedua parameter menerima nilai hingga 1000000; nilai yang lebih besar mengembalikan 400. count akurat hingga 100 dan tetap 100 di atas angka itu, sehingga jangan menggunakannya sebagai total. Terus minta URL next hingga bernilai null. Dengan session_kind=all, count adalah jumlah kedua jenis, masing-masing dibatasi 100.

Terkait

Ikhtisar sesi
Ambil sesi: keputusan lengkap untuk satu baris
Ikhtisar bisnis: entitas Bisnis yang diagregasi dari seluruh sesi
Ikhtisar pengguna: entitas Pengguna yang diagregasi dari seluruh sesi

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 Query

session_kind

enum<string>

default:user

Jenis sesi mana yang akan dicantumkan: user (khusus KYC, default), business (khusus KYB), atau all (keduanya, digabungkan - lihat deskripsi untuk semantik paginasi gabungan). Pencocokan bersifat tidak peka huruf besar/kecil (BUSINESS berfungsi); nilai apa pun selain variasi huruf dari user/business/all akan mengembalikan 400.

Opsi yang tersedia:

user,

business,

all

limit

integer

default:50

Jumlah baris maksimum per halaman (per jenis saat session_kind=all). Defaultnya 50.

Rentang yang diperlukan: 1 <= x <= 1000000

offset

integer

default:0

Jumlah baris yang dilewati sebelum baris pertama yang dikembalikan. Default-nya 0. Disarankan mengikuti URL next/previous dari respons.

Rentang yang diperlukan: 0 <= x <= 1000000

status

string

Daftar status sesi yang dipisahkan dengan koma untuk disertakan, misalnya Approved,In Review. Nilai bersifat case-sensitive; lihat Status Verifikasi. Nilai yang tidak dikenal tidak akan cocok dengan apa pun.

vendor_data

string

Filter kecocokan persis pada vendor_data yang Anda kirim saat pembuatan sesi (pengenal pengguna/bisnis Anda sendiri). Untuk kecocokan sebagian, gunakan search sebagai gantinya.

string

Referensi lengkap yang ditampilkan seperti S-0001 (pengguna) atau B-0001 (bisnis) hanya cocok dengan nomor dan jenis sesi tersebut; angka nol di awal dan huruf besar/kecil tidak memengaruhi pencocokan. Pencarian teks bebas pintar. UUID lengkap cocok dengan session_id; input numerik cocok dengan awalan nomor sesi, nomor dokumen/identitas pribadi, awalan telepon, atau vendor_data; input yang memuat @ cocok dengan awalan email; teks lainnya cocok dengan nama (tidak sensitif aksen) dan vendor_data. Teks bebas yang memuat digit juga cocok dengan kolom pencarian nomor dokumen/identitas pribadi dan awalan nomor sesi.

workflow_id

string

UUID alur kerja yang dipisahkan koma (temukan di halaman Alur Kerja di Konsol). UUID yang salah format dalam daftar akan diabaikan; jika tidak ada yang valid, hasilnya kosong.

date_from

string<date>

Hanya sesi yang dibuat pada atau setelah tanggal ini (UTC), format YYYY-MM-DD. Format tanggal yang salah akan mengembalikan 400.

date_to

string<date>

Hanya sesi yang dibuat hingga tanggal ini (UTC), format YYYY-MM-DD. Untuk baris KYC, seluruh hari disertakan; untuk baris KYB, perbandingannya adalah created_at <= date_to (tengah malam), jadi gunakan tanggal hari berikutnya untuk menyertakan sesi KYB satu hari penuh.

Respons

Daftar sesi terpaginasi. Item results berupa baris KYC, baris KYB, atau keduanya tergantung pada session_kind; bedakan dengan kolom session_kind di setiap baris.

count

integer

wajib

Jumlah sesi yang cocok dengan filter: tepat hingga 100 dan dibatasi maksimal 100 setelahnya, sehingga jangan gunakan sebagai total keseluruhan. Gunakan next untuk mengetahui apakah halaman berikutnya masih ada. Untuk session_kind=all, ini adalah jumlah kedua jenis, masing-masing dibatasi maksimal 100.

Contoh:

2

string<uri> | null

wajib

URL absolut halaman berikutnya, atau null di halaman terakhir.

Contoh:

"https://verification.didit.me/v3/sessions/?limit=20&offset=20"

string<uri> | null

wajib

URL absolut halaman sebelumnya, atau null di halaman pertama.

Contoh:

null

results

(KYC session row (session_kind: user) · object | KYB session row (session_kind: business) · object)[]

wajib

Baris sesi, terbaru terlebih dahulu. Dengan session_kind=all, baris KYC muncul lebih dulu, kemudian baris KYB.

Baris ringkasan untuk sesi Verifikasi Pengguna (KYC). Kolom identitas (full_name, country, document_type, portrait_image, kolom kontak) diisi secara bertahap saat pengguna menyelesaikan langkah verifikasi, dan bernilai null hingga langkah terkait selesai. Kolom yang dibatasi oleh konfigurasi atribut respons alur kerja juga dikembalikan sebagai null.

KYC session row (session_kind: user)
KYB session row (session_kind: business)

Show child attributes

Terakhir diubah pada 7 November 2026

​Filter jenis sesi

​Filter umum

​Contoh

​Bentuk baris berbeda menurut jenis

​Paginasi

​Terkait

Otorisasi

Parameter Query

Respons

Filter jenis sesi

Filter umum

Contoh

Bentuk baris berbeda menurut jenis

Paginasi

Terkait