Inizia
Integrazione / SDK
Verifica degli utenti
Verifica aziendale
Monitoraggio delle transazioni
Changelogcurl -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'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
for item in client.sessions.list():
print(item)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
for await (const item of didit.sessions.list()) {
console.log(item);
}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)
}import me.didit.Didit;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
for (var item : client.sessions().list()) {
System.out.println(item);
}<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
foreach ($didit->sessions->list() as $item) {
print_r($item);
}require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
didit.sessions.list.auto_paging_each do |item|
puts item.to_h
endusing 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
}
]
}API elenco sessioni: filtri per sessioni KYC e KYB
Elenca le sessioni di verifica con GET /v3/sessions/ e filtra per tipo, stato, workflow e dati vendor. API KYC e KYB unificata di Didit a consumo.
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'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
for item in client.sessions.list():
print(item)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
for await (const item of didit.sessions.list()) {
console.log(item);
}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)
}import me.didit.Didit;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
for (var item : client.sessions().list()) {
System.out.println(item);
}<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
foreach ($didit->sessions->list() as $item) {
print_r($item);
}require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
didit.sessions.list.auto_paging_each do |item|
puts item.to_h
endusing 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
}
]
}Filtro per tipo di sessione
Usa il parametro di querysession_kind per scegliere quale tipo di sessione restituire:
| Valore | Restituisce |
|---|---|
user (predefinito) | Solo sessioni di Verifica degli utenti (KYC). Comportamento retrocompatibile: ometti session_kind per ottenere questo risultato. |
business | Solo sessioni di Verifica aziendale (KYB). |
all | Sessioni sia di Verifica degli utenti sia di Verifica aziendale, concatenate. |
session_kind: "user" | "business", così il tuo client può gestire la struttura di ogni riga in base a questo campo.
Filtri comuni
Questi filtri si applicano a entrambi i tipi (i filtri riservati agli utenti vengono ignorati quandosession_kind=business, e viceversa):
| Parametro di query | Descrizione |
|---|---|
session_kind | user, business o all. Predefinito user. |
vendor_data | Corrispondenza esatta con il tuo identificativo. |
status | Uno o più stati, separati da virgole, scritti esattamente come li restituisce l’API: Approved, Declined, In Review e così via (vedi Stati di verifica). |
workflow_id | Filtra per il workflow utilizzato. |
country | Filtro per codice paese (utenti: issuing_states, aziende: country_code). |
date_from, date_to | Finestra della data di creazione (ISO 8601). |
tags | ID dei tag separati da virgole. Restituisce le sessioni che ne contengono almeno uno. |
decided_from, decided_to | Data e ora in formato ISO 8601. Restituisce le sessioni il cui stato è cambiato per l’ultima volta in quella finestra (da incluso, a escluso). Usano l’orario dell’ultimo cambio di stato, non quello di creazione. |
search | Un riferimento completo visualizzato, come S-0001 o B-0001, corrisponde solo a quel numero di sessione e a quel tipo, ignorando zeri iniziali e differenze tra maiuscole e minuscole. Per gli altri input, la ricerca viene eseguita nei campi esistenti relativi a nome, contatto, documento, numero di registrazione e vendor_data. |
Esempi
- Elenca sessioni di Verifica degli utenti (KYC) (predefinito)
- Elenca sessioni di Verifica aziendale (KYB)
- Elenca entrambi i tipi
curl -G https://verification.didit.me/v3/sessions/ \
-H "x-api-key: YOUR_API_KEY" \
--data-urlencode "vendor_data=user-42"
{
"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"
{
"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"
results. I consumatori devono gestire ogni riga in base a session_kind.all concatena i risultati invece di alternarli per timestamp. Per scansioni miste ad alto volume, richiama ciascun tipo separatamente e unisci i risultati lato client.Le forme delle righe cambiano in base al tipo
Le righe di Verifica degli utenti (KYC) includono:portrait_image, document_type, full_name, country (paese di emissione), phone_number, email_address e alcuni campi di revisione: assignee (il revisore della Console che detiene la sessione, o null), waiting_since e sla_due_at (valorizzati solo mentre la sessione è In Review), top_warnings (gli avvisi più importanti, ciascuno con risk, feature, log_type e short_description) e warnings_count.
Le righe di Verifica aziendale (KYB) includono: workflow_type, workflow_label, company_name, registration_number, country (paese di costituzione).
Entrambe contengono: session_id, session_kind, session_number, status, vendor_data, created_at.
Vedi Panoramica delle sessioni per la matrice completa delle funzionalità.
Paginazione
La paginazione usalimit (predefinito 50) e offset (predefinito 0), con URL assoluti next e previous nella risposta. Entrambi i parametri accettano valori fino a 1000000; un valore superiore restituisce 400.
count è esatto fino a 100 e resta a 100 oltre tale valore, quindi non usarlo come totale. Continua a richiedere l’URL next finché non è null. Con session_kind=all, count è la somma dei due tipi, ciascuno limitato a 100.
Correlati
- Panoramica delle sessioni
- Recupera sessione: decisione completa per una singola riga
- Panoramica delle aziende: l’entità Business aggregata tra le sessioni
- Panoramica degli utenti: l’entità User aggregata tra le sessioni
Autorizzazioni
La chiave API della tua applicazione, da Developers -> API keys nella Business Console. La chiave primaria ha accesso completo. Una chiave con nome può avere un ambito definito: nessuno, lettura o scrittura per risorsa, limitata ad alcuni workflow o a sessioni approvate, a un elenco di indirizzi IP e a una data di scadenza. 401 indica che la chiave è errata, revocata o scaduta; 403 indica che non è stata inviata alcuna chiave, che la chiave non ha accesso a questa risorsa o azione, oppure che la richiesta proviene da un indirizzo non incluso nel suo elenco IP; 404 su una route di sessione indica che la sessione non rientra nei workflow o negli stati previsti dalla chiave. Una chiave senza accesso ai media riceve gli URL di immagini, video e PDF come null, e una chiave senza permessi di scrittura sulle sessioni riceve link e token di sessione come null. Consulta https://docs.didit.me/console/api-keys.
Parametri della query
Quale tipo di sessioni elencare: user (solo KYC, predefinito), business (solo KYB) o all (entrambe, concatenate; consulta la descrizione per la semantica di paginazione unificata). La corrispondenza non fa distinzione tra maiuscole e minuscole (BUSINESS funziona); qualsiasi valore diverso da una variante di maiuscole/minuscole di user/business/all restituisce 400.
user, business, all Numero massimo di righe per pagina (per tipologia quando session_kind=all). Il valore predefinito è 50.
1 <= x <= 1000000Numero di righe da saltare prima della prima riga restituita. Il valore predefinito è 0. È preferibile seguire gli URL next/previous della risposta.
0 <= x <= 1000000Elenco separato da virgole degli stati della sessione da includere, ad es. Approved,In Review. I valori fanno distinzione tra maiuscole e minuscole; consulta Stati di verifica. I valori sconosciuti non corrispondono a nulla.
Filtro per corrispondenza esatta sul vendor_data inviato alla creazione della sessione (il tuo identificatore per l'utente/azienda). Per corrispondenze parziali, usa invece search.
Un riferimento visualizzato completo come S-0001 (utente) o B-0001 (azienda) corrisponde unicamente a quel numero e tipo di sessione; gli zeri iniziali e le maiuscole/minuscole non influiscono sulla corrispondenza. Ricerca intelligente a testo libero. Un UUID completo corrisponde a session_id; un input numerico corrisponde al prefisso del numero di sessione, ai numeri di documento/personali, al prefisso telefonico o a vendor_data; un input contenente @ corrisponde ai prefissi email; altro testo corrisponde ai nomi (senza distinzione di accenti) e a vendor_data. Il testo libero contenente cifre corrisponde inoltre ai campi di ricerca del numero di documento/personale e ai prefissi del numero di sessione.
UUID dei workflow separati da virgola (disponibili nella pagina Workflow della Console). Gli UUID non validi nell'elenco vengono ignorati; se nessuno è valido, il risultato è vuoto.
Solo le sessioni create in questa data o successivamente (UTC), formato YYYY-MM-DD. Le date con formato non valido restituiscono 400.
Solo le sessioni create fino a questa data (UTC), formato YYYY-MM-DD. Per le righe KYC viene inclusa l'intera giornata; per le righe KYB il confronto è created_at <= date_to (mezzanotte), quindi usa la data del giorno successivo per includere un'intera giornata di sessioni KYB.
ID di tag separati da virgole (tags della tua applicazione). Restituisce le sessioni che contengono uno qualsiasi di essi. Gli ID che non sono UUID validi vengono ignorati e, se nessuno è valido, l'elenco è vuoto.
Data e ora ISO 8601. Restituisce le sessioni il cui stato è cambiato l'ultima volta a partire da tale momento. Filtra in base all'orario dell'ultimo cambio di stato, non all'orario di creazione.
Data e ora ISO 8601. Restituisce le sessioni il cui stato è cambiato l'ultima volta prima di tale momento. Combina con decided_from per un intervallo semiaperto.
Filtro per paese separato da virgole. Per le righe KYC: codici ISO 3166-1 alpha-3 dello stato di emissione del documento d'identità (ad es. ESP,USA), che possono differire dalla nazionalità. Per le righe KYB: il codice del paese dell'azienda nel registro.
Codici dei tipi di documento di identità verificati nella sessione, separati da virgole (solo righe KYC): P (passaporto), ID (carta d'identità), DL (patente di guida), RP (permesso di soggiorno), SSC (tessera di sicurezza sociale), HIC (tessera sanitaria), WP (permesso di lavoro), TC (tesserino del codice fiscale), VISA, PSC (carta dei servizi pubblici), BC (certificato di nascita), OTHER. Nota che il campo di risposta document_type contiene il nome visualizzato, non il codice.
Nomi esatti dei documenti; è possibile passare più nomi separati da virgola, ma il valore viene suddiviso in corrispondenza delle virgole solo se contiene più di un separatore - (un singolo nome contenente una virgola interna viene confrontato per intero). I nomi corrispondono a quelli riconosciuti dalla verifica del documento (fronte o retro), ad es. Spain - Id Card (2021). Solo righe KYC.
Valori di regione/stato del documento separati da virgole (per documenti emessi su base regionale, come le patenti di guida statunitensi). Solo righe KYC.
Filtra per identificatore interno dell'utente di Didit (il campo di risposta didit_internal_id) per elencare tutte le sessioni di un utente verificato. Deve essere un UUID valido; i valori non validi restituiscono 400. Solo righe KYC.
Canali di creazione della sessione separati da virgole: API, HOSTED, MIGRATED. Il valore speciale ALL (o l'omissione del parametro) disabilita il filtro. Solo righe KYC.
Filtra le sessioni API standalone per servizio. I valori non validi restituiscono 400. Solo righe KYC.
ID_VERIFICATION, FACE_MATCH, AGE_ESTIMATION, FACE_SEARCH, POA, AML, KYB_REGISTRY, PASSIVE_LIVENESS, DATABASE_VALIDATION, PHONE_VERIFICATION, EMAIL_VERIFICATION Ricerca del nome senza distinzione di accenti all'interno dei dati sottoposti a screening AML e validazione su database. Se combinata con api_service=AML o api_service=DATABASE_VALIDATION, la ricerca è limitata ai dati sottoposti a screening di tale funzionalità. Solo righe KYC.
Codici di rischio degli avvisi separati da virgole; restituisce le sessioni che ne hanno generato alcuno (ad es. POSSIBLE_FRAUD). I codici di rischio sono elencati per funzionalità nella documentazione sugli avvisi. Si applica alle righe KYC e, con i codici di avviso aziendali, alle righe KYB.
Quando è true, include solo le sessioni la cui decisione è stata inizialmente impostata su In Review (utile per verificare il volume della revisione manuale). Solo righe KYC.
true restituisce le sessioni la cui verifica del documento è contrassegnata per la revisione manuale; false restituisce le sessioni la cui verifica del documento non è esplicitamente contrassegnata. Ometti per disattivare. Solo righe KYC.
Filtra in base all'euuid dell'utente finale (UUID assegnato all'utente in fase di verifica, utilizzato per i deep link della Console). Deve essere un UUID valido; valori non corretti restituiscono un errore di campo 400. Solo righe KYC.
Nomi delle organizzazioni separati da virgole. Destinato alla Console; con una chiave API (già limitata a una singola applicazione) corrisponde solo al nome della tua organizzazione.
Risposta
Elenco sessioni impaginato. Gli elementi di results sono righe KYC, righe KYB o entrambe a seconda di session_kind; distingui con il campo session_kind di ciascuna riga.
Numero di sessioni corrispondenti ai filtri: esatto fino a 100 e limitato a 100 oltre tale soglia, pertanto non utilizzarlo come totale complessivo. Usa next per sapere se esistono altre pagine. Per session_kind=all corrisponde alla somma di entrambi i tipi, ciascuno limitato a 100.
2
URL assoluto della pagina successiva, o null sull'ultima pagina.
"https://verification.didit.me/v3/sessions/?limit=20&offset=20"
URL assoluto della pagina precedente, o null sulla prima pagina.
null
Righe delle sessioni, dalla più recente. Con session_kind=all, vengono prima le righe KYC, poi quelle KYB.
Riga di riepilogo per una sessione di Verifica degli utenti (KYC). I campi di identità (full_name, country, document_type, portrait_image, campi di contatto) vengono popolati progressivamente man mano che l'utente completa i passaggi di verifica, e sono null fino al termine del passaggio pertinente. Anche i campi soggetti a restrizioni dalla configurazione degli attributi di risposta del workflow vengono restituiti come null.
- KYC session row (session_kind: user)
- KYB session row (session_kind: business)
Show child attributes
Show child attributes