Sitzungen auflisten API: KYC- & KYB-Sitzungen filtern

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 nach Sitzungsart

Verwenden Sie den Query-Parameter session_kind, um festzulegen, welche Art von Sitzungen zurückgegeben wird:

Wert	Liefert
`user` (Standard)	Nur Sitzungen der Benutzerverifizierung (KYC). Abwärtskompatibles Verhalten: Lassen Sie `session_kind` weg, um dieses Ergebnis zu erhalten.
`business`	Nur Sitzungen der Unternehmensverifizierung (KYB).
`all`	Sitzungen der Benutzerverifizierung und der Unternehmensverifizierung, hintereinander ausgegeben.

Jede Zeile der Antwort enthält session_kind: "user" | "business", damit Ihr Client die Struktur pro Zeile unterscheiden kann.

Gemeinsame Filter

Diese Filter gelten für beide Arten. Die nur für Benutzer vorgesehenen Filter werden ignoriert, wenn session_kind=business gesetzt ist, und umgekehrt:

Query-Parameter	Beschreibung
`session_kind`	`user`, `business` oder `all`. Standard: `user`.
`vendor_data`	Exakte Übereinstimmung mit Ihrer Kennung.
`status`	Ein oder mehrere Status, durch Kommas getrennt, genau so geschrieben, wie die API sie zurückgibt: `Approved`, `Declined`, `In Review` usw. (siehe Verifizierungsstatus).
`workflow_id`	Filtert nach dem verwendeten Workflow.
`country`	Filter nach Ländercode (Benutzer: `issuing_states`, Unternehmen: `country_code`).
`date_from`, `date_to`	Zeitfenster für das Erstellungsdatum (ISO 8601).
`tags`	Durch Kommas getrennte Tag-IDs. Liefert die Sitzungen zurück, die mindestens einen davon enthalten.
`decided_from`, `decided_to`	ISO-8601-Zeitstempel. Liefert die Sitzungen zurück, deren Status in diesem Zeitfenster zuletzt geändert wurde (Beginn inklusive, Ende exklusive). Maßgeblich ist der Zeitpunkt der letzten Statusänderung, nicht der Erstellungszeitpunkt.
`search`	Eine vollständige angezeigte Referenz wie `S-0001` oder `B-0001` passt nur auf diese Sitzungsnummer und Art und ignoriert führende Nullen sowie Groß- und Kleinschreibung. Andere Eingaben durchsuchen die vorhandenen Felder für Name, Kontakt, Dokument, Registernummer und `vendor_data`.

Beispiele

Sitzungen der Benutzerverifizierung (KYC) auflisten (Standard)
Sitzungen der Unternehmensverifizierung (KYB) auflisten
Beide Arten auflisten

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

Antwort (gekürzt):

{
  "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"

Antwort (gekürzt):

{
  "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"

Liefert Zeilen der Benutzerverifizierung und der Unternehmensverifizierung in einem einzigen Array results. Ihre Anwendung sollte pro Zeile anhand von session_kind unterscheiden.

Der Modus all hängt die Ergebnisse aneinander, statt sie nach Zeitstempel abwechselnd anzuordnen. Bei umfangreichen gemischten Abfragen sollten Sie jede Art separat aufrufen und clientseitig zusammenführen.

Zeilenstrukturen unterscheiden sich nach Art

Zeilen der Benutzerverifizierung (KYC) enthalten portrait_image, document_type, full_name, country (Ausstellungsstaat), phone_number, email_address sowie einige Prüffelder: assignee (der Prüfer in der Console, dem die Sitzung zugewiesen ist, oder null), waiting_since und sla_due_at (nur gesetzt, solange die Sitzung In Review ist), top_warnings (die wichtigsten Warnungen, jeweils mit risk, feature, log_type und short_description) und warnings_count. Zeilen der Unternehmensverifizierung (KYB) enthalten workflow_type, workflow_label, company_name, registration_number und country (Gründungsland). Beide enthalten session_id, session_kind, session_number, status, vendor_data und created_at. Die vollständige Funktionsmatrix finden Sie unter Sitzungsübersicht.

Paginierung

Die Paginierung verwendet limit (Standard 50) und offset (Standard 0). Die Antwort enthält absolute URLs für next und previous. Beide Parameter akzeptieren Werte bis 1000000; ein größerer Wert liefert 400. count ist bis 100 exakt und bleibt darüber bei 100. Verwenden Sie den Wert daher nicht als Gesamtzahl. Rufen Sie die URL in next so lange ab, bis sie null ist. Bei session_kind=all ist count die Summe beider Arten, wobei jede Art auf 100 begrenzt ist.

Verwandte Themen

Sitzungsübersicht
Sitzung abrufen: vollständige Entscheidung für eine einzelne Zeile
Unternehmensübersicht: die Entität Unternehmen, zusammengefasst über Sitzungen
Benutzerübersicht: die Entität Benutzer, zusammengefasst über Sitzungen

Autorisierungen

x-api-key

string

header

erforderlich

Der API-Schlüssel Ihrer Anwendung, aus Entwickler -> API-Schlüssel in der Business Console. Der Primärschlüssel hat Vollzugriff. Ein benannter Schlüssel kann im Geltungsbereich eingeschränkt werden: keine, Lese- oder Schreibberechtigung pro Ressource, beschränkt auf bestimmte Workflows oder genehmigte Sitzungen, auf eine Liste von IP-Adressen und auf ein Ablaufdatum. 401 bedeutet, dass der Schlüssel falsch, widerrufen oder abgelaufen ist; 403 bedeutet, dass kein Schlüssel gesendet wurde, der Schlüssel keinen Zugriff auf diese Ressource oder Aktion hat oder die Anfrage von einer Adresse außerhalb seiner IP-Liste stammte; 404 bei einer Sitzungsroute bedeutet, dass die Sitzung außerhalb der Workflows oder Status des Schlüssels liegt. Ein Schlüssel ohne Medienzugriff erhält Bild-, Video- und PDF-URLs als null, und ein Schlüssel ohne Schreibberechtigung für Sitzungen erhält Sitzungslinks und Token als null. Siehe https://docs.didit.me/console/api-keys.

Abfrageparameter

session_kind

enum<string>

Standard:user

Welche Art von Sitzungen aufgelistet werden soll: user (nur KYC, Standard), business (nur KYB) oder all (beide verkettet - siehe Beschreibung für die Semantik der zusammengeführten Paginierung). Beim Abgleich wird die Groß-/Kleinschreibung nicht berücksichtigt (BUSINESS funktioniert); jeder andere Wert als eine Schreibweisenvariante von user/business/all gibt 400 zurück.

Verfügbare Optionen:

user,

business,

all

limit

integer

Standard:50

Maximale Anzahl an Zeilen pro Seite (pro Art, wenn session_kind=all). Standardmäßig 50.

Erforderlicher Bereich: 1 <= x <= 1000000

offset

integer

Standard:0

Anzahl der vor der ersten zurückgegebenen Zeile zu überspringenden Zeilen. Standardmäßig 0. Folgen Sie vorzugsweise den next/previous-URLs aus der Antwort.

Erforderlicher Bereich: 0 <= x <= 1000000

status

string

Kommagetrennte Liste der einzuschließenden Sitzungsstatus, z. B. Approved,In Review. Bei den Werten wird zwischen Groß- und Kleinschreibung unterschieden; siehe Verifizierungsstatus. Unbekannte Werte stimmen mit nichts überein.

vendor_data

string

Exakter Übereinstimmungsfilter für die vendor_data, die Sie bei der Sitzungserstellung übermittelt haben (Ihre eigene Benutzer-/Unternehmenskennung). Für Teilübereinstimmungen verwenden Sie stattdessen search.

string

Eine vollständige angezeigte Referenz wie S-0001 (Benutzer) oder B-0001 (Unternehmen) stimmt nur mit dieser Sitzungsnummer und Art überein; führende Nullen und Groß-/Kleinschreibung haben keinen Einfluss auf die Übereinstimmung. Intelligente Freitextsuche. Eine vollständige UUID stimmt mit session_id überein; numerische Eingaben stimmen mit Sitzungsnummern-Präfixen, Dokumenten-/persönlichen Nummern, Telefonvorwahlen oder vendor_data überein; Eingaben mit @ stimmen mit E-Mail-Präfixen überein; anderer Text stimmt mit Namen (ohne Berücksichtigung von Akzenten) und vendor_data überein. Freitext mit Ziffern stimmt zusätzlich mit Suchfeldern für Dokumenten-/persönliche Nummern und Sitzungsnummern-Präfixen überein.

workflow_id

string

Kommagetrennte Workflow-UUIDs (Sie finden sie auf der Seite „Workflows“ in der Console). Ungültig formatierte UUIDs in der Liste werden ignoriert; wenn keine gültig ist, ist das Ergebnis leer.

date_from

string<date>

Nur Sitzungen, die an oder nach diesem Datum (UTC) erstellt wurden, Format YYYY-MM-DD. Fehlerhafte Datumsangaben geben 400 zurück.

date_to

string<date>

Nur Sitzungen, die bis zu diesem Datum (UTC) erstellt wurden, Format YYYY-MM-DD. Für KYC-Zeilen wird der gesamte Tag einbezogen; für KYB-Zeilen lautet der Vergleich created_at <= date_to (Mitternacht), verwenden Sie daher das Datum des nächsten Tages, um einen vollständigen Tag mit KYB-Sitzungen einzuschließen.

Antwort

Paginierte Sitzungsliste. results-Einträge sind je nach session_kind KYC-Zeilen, KYB-Zeilen oder beides; unterscheiden Sie anhand des Felds session_kind jeder Zeile.

count

integer

erforderlich

Anzahl der den Filtern entsprechenden Sitzungen: exakt bis 100 und darüber auf 100 begrenzt, verwenden Sie sie daher nicht als Gesamtsumme. Nutzen Sie next, um zu erfahren, ob weitere Seiten vorhanden sind. Bei session_kind=all ist es die Summe beider Arten, jeweils auf 100 begrenzt.

Beispiel:

2

string<uri> | null

erforderlich

Absolute URL der nächsten Seite oder null auf der letzten Seite.

Beispiel:

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

string<uri> | null

erforderlich

Absolute URL der vorherigen Seite oder null auf der ersten Seite.

Beispiel:

null

results

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

erforderlich

Sitzungszeilen, neueste zuerst. Bei session_kind=all stehen KYC-Zeilen an erster Stelle, gefolgt von KYB-Zeilen.

Zusammenfassungszeile für eine Benutzerverifizierungs-Sitzung (KYC). Identitätsfelder (full_name, country, document_type, portrait_image, Kontaktfelder) werden schrittweise ausgefüllt, während der Benutzer die Verifizierungsschritte abschließt, und sind null, bis der entsprechende Schritt abgeschlossen ist. Felder, die durch die Konfiguration der Antwortattribute des Workflows eingeschränkt sind, werden ebenfalls als null zurückgegeben.

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

Show child attributes

Zuletzt geändert am 7. November 2026

​Filter nach Sitzungsart

​Gemeinsame Filter

​Beispiele

​Zeilenstrukturen unterscheiden sich nach Art

​Paginierung

​Verwandte Themen

Autorisierungen

Abfrageparameter

Antwort

Filter nach Sitzungsart

Gemeinsame Filter

Beispiele

Zeilenstrukturen unterscheiden sich nach Art

Paginierung

Verwandte Themen