API elenco eventi di sessione

curl

curl -X GET 'https://verification.didit.me/v3/session/11111111-2222-3333-4444-555555555555/events/?limit=50' \
  -H 'x-api-key: YOUR_API_KEY'

import Didit from "@didit-protocol/sdk-node";

// Reads DIDIT_API_KEY.
const didit = new Didit();

for await (const item of didit.sessions.listEvents("11111111-2222-3333-4444-555555555555")) {
  console.log(item);
}

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

iter := client.Sessions.ListEventsAutoPaging(ctx, "11111111-2222-3333-4444-555555555555", didit.SessionsListEventsParams{})
for iter.Next() {
	fmt.Printf("%+v\n", iter.Current())
}
if err := iter.Err(); err != nil {
	log.Fatal(err)
}

<?php

require 'vendor/autoload.php';

use Didit\DiditClient;

// Reads DIDIT_API_KEY.
$didit = new DiditClient();

foreach ($didit->sessions->listEvents('11111111-2222-3333-4444-555555555555') as $item) {
    print_r($item->toArray());
}

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.ListEventsAsync("11111111-2222-3333-4444-555555555555"))
{
    Console.WriteLine(JsonSerializer.Serialize(item));
}

{
  "count": 3,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "aaaaaaaa-1111-2222-3333-444444444444",
      "event_type": "SESSION_STATUS_CHANGED",
      "created_at": "2026-09-14T10:02:13.904512Z",
      "component": null,
      "feature_step": null,
      "step": null,
      "details": {
        "old_status": "In Progress",
        "current_status": "Approved"
      },
      "ip_address": null,
      "user_agent": null,
      "device_info": null,
      "file_url": null,
      "sent_at": 1789380131482
    },
    {
      "uuid": "bbbbbbbb-1111-2222-3333-444444444444",
      "event_type": "FEATURE_STEP_CHANGED",
      "created_at": "2026-09-14T10:01:49.210377Z",
      "component": null,
      "feature_step": null,
      "step": null,
      "details": {
        "old_feature_step": "OCR",
        "current_feature_step": "LIVENESS"
      },
      "ip_address": null,
      "user_agent": null,
      "device_info": null,
      "file_url": null,
      "sent_at": 1789380107103
    },
    {
      "uuid": "cccccccc-1111-2222-3333-444444444444",
      "event_type": "STEP_RENDERED",
      "created_at": "2026-09-14T10:01:00.581930Z",
      "component": "DocumentCapture",
      "feature_step": "OCR",
      "step": "DOCUMENT_CAPTURE_FRONT",
      "details": {},
      "ip_address": "203.0.113.24",
      "user_agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 18_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.5 Mobile/15E148 Safari/604.1",
      "device_info": {
        "device_model": "iPhone"
      },
      "file_url": null,
      "sent_at": 1789380058776
    }
  ]
}

GET

session

{sessionId}

events

curl

curl -X GET 'https://verification.didit.me/v3/session/11111111-2222-3333-4444-555555555555/events/?limit=50' \
  -H 'x-api-key: YOUR_API_KEY'

import Didit from "@didit-protocol/sdk-node";

// Reads DIDIT_API_KEY.
const didit = new Didit();

for await (const item of didit.sessions.listEvents("11111111-2222-3333-4444-555555555555")) {
  console.log(item);
}

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

iter := client.Sessions.ListEventsAutoPaging(ctx, "11111111-2222-3333-4444-555555555555", didit.SessionsListEventsParams{})
for iter.Next() {
	fmt.Printf("%+v\n", iter.Current())
}
if err := iter.Err(); err != nil {
	log.Fatal(err)
}

<?php

require 'vendor/autoload.php';

use Didit\DiditClient;

// Reads DIDIT_API_KEY.
$didit = new DiditClient();

foreach ($didit->sessions->listEvents('11111111-2222-3333-4444-555555555555') as $item) {
    print_r($item->toArray());
}

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.ListEventsAsync("11111111-2222-3333-4444-555555555555"))
{
    Console.WriteLine(JsonSerializer.Serialize(item));
}

{
  "count": 3,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "aaaaaaaa-1111-2222-3333-444444444444",
      "event_type": "SESSION_STATUS_CHANGED",
      "created_at": "2026-09-14T10:02:13.904512Z",
      "component": null,
      "feature_step": null,
      "step": null,
      "details": {
        "old_status": "In Progress",
        "current_status": "Approved"
      },
      "ip_address": null,
      "user_agent": null,
      "device_info": null,
      "file_url": null,
      "sent_at": 1789380131482
    },
    {
      "uuid": "bbbbbbbb-1111-2222-3333-444444444444",
      "event_type": "FEATURE_STEP_CHANGED",
      "created_at": "2026-09-14T10:01:49.210377Z",
      "component": null,
      "feature_step": null,
      "step": null,
      "details": {
        "old_feature_step": "OCR",
        "current_feature_step": "LIVENESS"
      },
      "ip_address": null,
      "user_agent": null,
      "device_info": null,
      "file_url": null,
      "sent_at": 1789380107103
    },
    {
      "uuid": "cccccccc-1111-2222-3333-444444444444",
      "event_type": "STEP_RENDERED",
      "created_at": "2026-09-14T10:01:00.581930Z",
      "component": "DocumentCapture",
      "feature_step": "OCR",
      "step": "DOCUMENT_CAPTURE_FRONT",
      "details": {},
      "ip_address": "203.0.113.24",
      "user_agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 18_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.5 Mobile/15E148 Safari/604.1",
      "device_info": {
        "device_model": "iPhone"
      },
      "file_url": null,
      "sent_at": 1789380058776
    }
  ]
}

Gli eventi di instradamento del workflow (WORKFLOW_BRANCH_EVALUATED, WORKFLOW_STATUS_NODE_REACHED) e i relativi details sono descritti in Recupero di una sessione, che può anche restituire la cronologia di una sessione di verifica degli utenti (KYC) all’interno della sua decisione con ?include=events.

Autorizzazioni

x-api-key

string

header

obbligatorio

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 del percorso

sessionId

string<uuid>

obbligatorio

UUID della sessione di verifica (il session_id restituito da POST /v3/session/). Accetta sia ID di sessione di Verifica degli utenti (KYC) sia di Verifica aziendale (KYB): il server risolve l'ID per entrambi i tipi di sessione. Deve essere un UUID ben formato; un valore malformato non corrisponde alla route e restituisce una pagina HTML 404.

Esempio:

"11111111-2222-3333-4444-555555555555"

Parametri della query

limit

integer

predefinito:50

Numero massimo di eventi per pagina. Il valore predefinito è 50. Un valore inferiore a 1 o non numerico viene reimpostato su 50; un valore superiore a 1,000,000 restituisce 400.

Intervallo richiesto: 1 <= x <= 1000000

Esempio:

50

offset

integer

predefinito:0

Numero di risultati da saltare prima del primo restituito. Il valore predefinito è 0; un valore negativo o non numerico reimposta il valore a 0, un valore superiore a 1,000,000 restituisce 400. È preferibile seguire gli URL next e previous.

Intervallo richiesto: 0 <= x <= 1000000

Esempio:

0

ordering

string

Criterio di ordinamento opzionale alternativo. L'ordine predefinito è -sent_at. Passa il nome di un campo dei risultati (ad esempio sent_at, created_at, event_type, feature_step o step) per ordinare in modo crescente, anteponi - per ordinare in modo decrescente e separa più campi con virgole. I campi sconosciuti vengono ignorati.

Esempio:

"sent_at"

Risposta

Una pagina degli eventi della sessione, dal più recente al meno recente.

count

integer

obbligatorio

Numero totale di eventi della sessione.

string<uri> | null

obbligatorio

URL della pagina successiva, o null nell'ultima pagina.

string<uri> | null

obbligatorio

URL della pagina precedente, o null nella prima pagina.

results

object[]

obbligatorio

Show child attributes

Ultima modifica il 7 novembre 2026