> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # Manuelle Prüfungen pro Sitzung abrufen: KYC-Audit-Log > Alle manuellen Prüfnotizen und Statusänderungen einer Didit-Sitzung abrufen. Revisionsfähiges KYC-Log, pro Aufruf, keine Verträge. Prompt zum Auflisten von Sitzungsprüfungen Prompt in die Zwischenablage kopieren \

\``Goal: Fetch the full review/activity feed for a Didit verification session — manual comments, status changes, KYC/KYB edits, file uploads, AML events, tags. Mirrors the timeline shown on the Console session-detail page.

Endpoint: GET https://verification.didit.me/v3/sessions/{session_id}/reviews/
Auth header: x-api-key: YOUR_API_KEY

Path param:
\- session_id (UUID, REQUIRED) — verification session UUID. Cross-application reads return 404.

curl:
curl -s 'https://verification.didit.me/v3/sessions/8c2f3a14-7e9b-4d23-9e83-3f7d5e8a1c6d/reviews/' \
-H "x-api-key: $DIDIT_API_KEY"

Response 200: JSON ARRAY (no envelope, no pagination — feed is bounded). Newest first. Each entry (ReviewItem) has:
\- uuid (UUID)
\- activity_type: "COMMENT" | "STATUS_UPDATED" | "KYC_DATA_UPDATED" | "POA_DATA_UPDATED" | "FILE_ADDED" | "FILE_REMOVED" | "AML_ONGOING_MATCH" | "AML_STATUS_UPDATED" | "AML_HIT_STATUS_UPDATED" | "KYB_DATA_UPDATED" | "KYB_DOCUMENT_UPLOADED" | "TAG_ADDED" | "TAG_REMOVED"
\- actor_email, actor_display, actor_type: "API_KEY" | "CONSOLE_USER" | "SYSTEM"
\- new_status, previous_status — only populated for STATUS_UPDATED/AML_STATUS_UPDATED. Values from the SESSION status enum: "Not Started" | "In Progress" | "Awaiting User" | "In Review" | "Approved" | "Declined" | "Resubmitted" | "Expired" | "Kyc Expired" | "Abandoned".
\- comment (string | null)
\- mentioned_emails (string[]) — extracted @mentions, only for COMMENT activities
\- previous_value, new_value, changed_fields — diff payload for *_DATA_UPDATED, FILE_*, TAG_* (opaque JSON, shape varies per activity_type)
\- metadata (object | null)
\- created_at (ISO 8601 UTC)
Empty array means the session has had no recorded activity yet.

When to use:
\- Render an audit trail mirror on your own dashboard.
\- Export the feed for compliance archives.
\- Poll for manual-review decisions when you can't consume webhooks (filter activity_type === "STATUS_UPDATED"; inspect new_status). Webhooks are still preferred — see /integration/webhooks.

Failure modes (envelope {"detail": "..."}):
\- 401 — missing/invalid `x-api-key` header. Re-fetch your application API key from the Auth API if needed.
\- 403 — API key valid but the application is not allowed (revoked, expired, or wrong app).
\- 404 — session UUID does not exist, has been deleted, or belongs to a different application.
\- 429 — rate-limited. Inspect Retry-After.

For end-to-end Didit integration, paste in the full prompt at /integration/integration-prompt.``

\
Einfügen in ## OpenAPI ````yaml de/openapi-25.json GET /v3/sessions/{session_id}/reviews/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API für Ausweisverifizierung. Authentifizierung über den x-api-key-Header. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/sessions/{session_id}/reviews/: get: tags: - Sessions summary: Sitzungsprüfungen und Aktivitäts-Log auflisten description: >- Gibt den Audit-Trail / Aktivitäts-Feed für eine Sitzung der Benutzerverifizierung (KYC) zurück, die neuesten zuerst, in einem paginierten Container (`count` / `next` / `previous` / `results`, standardmäßig 50 Einträge pro Seite). Feed-Einträge werden von jedem Akteur verfasst, der mit der Sitzung interagiert: manuelle Entscheidungen über `PATCH /v3/session/{session_id}/update-status/` (zeichnet `previous_status` → `new_status` auf), Prüferaktivitäten in der Console (Kommentare mit `@email`-Erwähnungen, Bearbeitungen von KYC/POA-Daten, Hochladen/Entfernen von Dateien, Tag-Änderungen, Aufrufe der Detailseite), Treffer der laufenden AML-Überwachung sowie über `POST` auf demselben Pfad hinzugefügte Notizen. Das Auslesen dieses Feeds ist das API-seitige Äquivalent zum Bereich **Activity** in der Sitzungsansicht der Didit Console. Hier können nur Sitzungen der Benutzerverifizierung (KYC) adressiert werden; Sitzungs-IDs der Unternehmensverifizierung (KYB) geben `404` zurück. operationId: list_session_reviews parameters: - name: session_id in: path required: true description: >- UUID der Sitzung zur Benutzerverifizierung (KYC). Muss zu derselben Anwendung wie der API-Schlüssel gehören — anwendungsübergreifende UUIDs, gelöschte Sitzungen und Sitzungs-IDs der Unternehmensverifizierung (KYB) geben alle `404` zurück. schema: type: string format: uuid example: 8c2f3a14-7e9b-4d23-9e83-3f7d5e8a1c6d - name: limit in: query required: false description: Seitengröße. Standardmäßig `50`. schema: type: integer default: 50 example: 50 - name: offset in: query required: false description: >- Anzahl der vom Beginn des (sortierten) Feeds zu überspringenden Einträge. Standardmäßig `0`. Die `next`- / `previous`-URLs in der Antwort enthalten die richtigen Werte zum Durchlaufen des Feeds. schema: type: integer default: 0 example: 0 - name: ordering in: query required: false description: >- Sortierreihenfolge. Der Feed verwendet standardmäßig die neuesten zuerst (`-created_at`); übergeben Sie `created_at`, um ihn von den ältesten zuerst zu lesen. Unbekannte Werte werden stillschweigend ignoriert (die Standardreihenfolge wird verwendet); andere Serializer-Feldnamen werden ebenfalls akzeptiert. schema: type: string default: '-created_at' example: created_at responses: '200': description: >- Paginierter Aktivitäts-Feed, standardmäßig die neuesten zuerst. `count` ist die Gesamtzahl der Einträge; `next` / `previous` sind fertige Seiten-URLs (`null` an den Enden). Ein `count` von `0` mit leeren `results` bedeutet, dass noch keine Aktivität erfasst wurde. content: application/json: schema: type: object properties: count: type: integer description: >- Gesamtzahl der Feed-Einträge für diese Sitzung (über alle Seiten hinweg). example: 3 next: type: string nullable: true description: URL der nächsten Seite oder `null` auf der letzten Seite. example: null previous: type: string nullable: true description: URL der vorherigen Seite oder `null` auf der ersten Seite. example: null results: type: array items: $ref: '#/components/schemas/ReviewItem' description: Feed-Einträge für diese Seite. examples: DecisionTrail: summary: >- Manuelle Genehmigung zuzüglich über die API hinzugefügter Notizen value: count: 3 next: null previous: null results: - uuid: de0561bc-5583-4409-9171-1a31a4c8a5f4 activity_type: STATUS_UPDATED actor_display: API Client actor_email: null actor_type: API_KEY new_status: Approved previous_status: In Review comment: Document re-checked manually; address matches. mentioned_emails: [] previous_value: status: In Review new_value: status: Approved changed_fields: - status metadata: null created_at: '2026-06-12T00:19:31.918735Z' - uuid: 35370f58-5098-44ee-8a06-8c9af80b2455 activity_type: STATUS_UPDATED actor_display: Unknown actor_email: null actor_type: CONSOLE_USER new_status: null previous_status: null comment: Note without status. mentioned_emails: [] previous_value: null new_value: null changed_fields: [] metadata: null created_at: '2026-06-12T00:18:44.504157Z' - uuid: 00338f82-f1c5-4f57-8614-c49bb258af1a activity_type: STATUS_UPDATED actor_display: Unknown actor_email: null actor_type: CONSOLE_USER new_status: In Review previous_status: null comment: Flagging for manual document re-check. mentioned_emails: [] previous_value: null new_value: null changed_fields: [] metadata: null created_at: '2026-06-12T00:18:44.466537Z' PaginatedFirstPage: summary: Erste Seite mit limit=2 – next enthält die Folge-URL value: count: 4 next: >- https://verification.didit.me/v3/sessions/8c2f3a14-7e9b-4d23-9e83-3f7d5e8a1c6d/reviews/?limit=2&offset=2 previous: null results: - uuid: de0561bc-5583-4409-9171-1a31a4c8a5f4 activity_type: STATUS_UPDATED actor_display: API Client actor_email: null actor_type: API_KEY new_status: Approved previous_status: In Review comment: Document re-checked manually; address matches. mentioned_emails: [] previous_value: status: In Review new_value: status: Approved changed_fields: - status metadata: null created_at: '2026-06-12T00:19:31.918735Z' - uuid: bd4e6227-bdd2-42b2-a726-1d12f785a457 activity_type: STATUS_UPDATED actor_display: Unknown actor_email: null actor_type: CONSOLE_USER new_status: null previous_status: null comment: null mentioned_emails: [] previous_value: null new_value: null changed_fields: [] metadata: null created_at: '2026-06-12T00:18:44.540238Z' Empty: summary: Sitzung noch ohne erfasste Aktivität value: count: 0 next: null previous: null results: [] '403': description: >- Fehlender, fehlerhafter, abgelaufener oder widerrufener `x-api-key`. Die Authentifizierung wird vor dem Nachschlagen der Sitzung geprüft, sodass ein fehlender Schlüssel auch dann `403` zurückgibt, wenn die Sitzungs-UUID nicht existiert. content: application/json: schema: type: object properties: detail: type: string example: You do not have permission to perform this action. examples: InvalidKey: summary: Fehlender oder ungültiger Header x-api-key value: detail: You do not have permission to perform this action. '404': description: >- Für Ihre Anwendung ist keine Benutzerverifizierungs-Sitzung (KYC) mit dieser UUID sichtbar: Die UUID existiert nicht, die Sitzung wurde gelöscht oder gehört zu einer anderen Anwendung. Unternehmensverifizierungs-Sitzungs-IDs (KYB) geben hier ebenfalls `404` zurück – der Prüfungs-Feed ist nur für KYC-Sitzungen adressierbar. content: application/json: schema: type: object properties: detail: type: string example: Session not found. examples: NotFound: summary: >- Unbekannte, gelöschte oder anwendungsübergreifende Sitzungs-UUID value: detail: Session not found. '429': description: >- Rate-Limit überschritten. Prüfen Sie die Antwort-Header `Retry-After` und `X-RateLimit-*`. Siehe [Rate-Limiting](/de/integration/rate-limiting). security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: >- curl -s 'https://verification.didit.me/v3/sessions/8c2f3a14-7e9b-4d23-9e83-3f7d5e8a1c6d/reviews/?limit=50' \ -H 'x-api-key: YOUR_API_KEY' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() for item in client.sessions.reviews.list( "8c2f3a14-7e9b-4d23-9e83-3f7d5e8a1c6d", ): print(item) - lang: javascript label: Node.js source: >- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); for await (const item of didit.sessions.reviews.list("8c2f3a14-7e9b-4d23-9e83-3f7d5e8a1c6d")) { console.log(item); } - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\niter := client.Sessions.Reviews.ListAutoPaging(ctx, \"8c2f3a14-7e9b-4d23-9e83-3f7d5e8a1c6d\", didit.SessionsReviewsListParams{})\nfor iter.Next() {\n\tfmt.Printf(\"%+v\\n\", iter.Current())\n}\nif err := iter.Err(); err != nil {\n\tlog.Fatal(err)\n}" - lang: java label: Java source: >- import me.didit.Didit; // Reads DIDIT_API_KEY. Didit client = new Didit(); for (var item : client.sessions().reviews().list("8c2f3a14-7e9b-4d23-9e83-3f7d5e8a1c6d")) { System.out.println(item); } - lang: php label: PHP source: >- sessions->reviews->list('8c2f3a14-7e9b-4d23-9e83-3f7d5e8a1c6d') as $item) { print_r($item->toArray()); } - lang: ruby label: Ruby source: >- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new didit.sessions.reviews.list("8c2f3a14-7e9b-4d23-9e83-3f7d5e8a1c6d").auto_paging_each do |item| puts item.to_h end - lang: csharp label: .NET source: >- 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.Reviews.ListAsync("8c2f3a14-7e9b-4d23-9e83-3f7d5e8a1c6d")) { Console.WriteLine(JsonSerializer.Serialize(item)); } components: schemas: ReviewItem: type: object description: >- Ein Eintrag im Prüfungs-/Aktivitäts-Feed einer Sitzung. Statusänderungen enthalten `previous_status`, `new_status`, `previous_value`, `new_value` und `changed_fields`; Kommentare enthalten `comment` und (bei Kommentaren aus der Console) `mentioned_emails`; die übrigen Felder sind `null` oder leer, wenn sie für den Aktivitätstyp nicht zutreffen. properties: uuid: type: string format: uuid description: Eindeutige Kennung dieses Feed-Eintrags. example: de0561bc-5583-4409-9171-1a31a4c8a5f4 activity_type: type: string enum: - COMMENT - STATUS_UPDATED - KYC_DATA_UPDATED - POA_DATA_UPDATED - FILE_ADDED - FILE_REMOVED - AML_ONGOING_MATCH - AML_STATUS_UPDATED - AML_HIT_STATUS_UPDATED - KYB_DATA_UPDATED - KYB_DOCUMENT_UPLOADED - TAG_ADDED - TAG_REMOVED - FEATURE_OVERRIDE_PENDING - FEATURE_OVERRIDE_APPLIED - FEATURE_OVERRIDE_CANCELLED description: >- Welche Art von Aktivität dieser Eintrag aufzeichnet. `STATUS_UPDATED`-Zeilen stammen aus manuellen Entscheidungen (`PATCH /v3/session/{session_id}/update-status/`) und aus über `POST …/reviews/` hinzugefügten Einträgen (die standardmäßig diesen Typ haben, selbst wenn kein Status erfasst wird). `COMMENT`-Zeilen stammen von Console-Prüfern; Aufrufe der Detailseite in der Console werden ebenfalls als `COMMENT`-Zeilen gespeichert und mit `metadata.system_event = "DETAIL_VIEWED"` markiert. Die übrigen Typen verfolgen Datenbearbeitungen, Dateiänderungen, Tags und AML-Überwachungsaktivitäten. STATUS_UPDATED-Zeilen werden auch von System-Akteuren geschrieben (z. B. laufende AML-Überwachung mit actor_type SYSTEM und automatische Aktualisierungen des Funktionsstatus), nicht nur durch den Update-Status-Endpoint und manuelle Prüfungsbeiträge. `FEATURE_OVERRIDE_PENDING`, `FEATURE_OVERRIDE_APPLIED` und `FEATURE_OVERRIDE_CANCELLED` zeichnen ein Überschreiben des Status einer Prüfung auf (`PATCH /v3/session/{session_id}/features/{node_id}/update-status/`): angefordert, um auf den Abschluss des Ablaufs zu warten, angewendet oder abgebrochen. Sie enthalten den Status der Prüfung in `previous_value` / `new_value` (`{"status": ...}`), belassen `previous_status` und `new_status` auf `null` und benennen das Überschreiben in `metadata` (`feature_override_id`, `node_id`, `feature_model`, `forced`, `state`, `cancel_reason`). Der Eintrag für die Anfrage enthält den `comment` des Prüfers; ein Überschreiben, das angewendet wird, wenn der Ablauf abgeschlossen ist, wird mit dem `actor_type` `SYSTEM` erfasst. example: STATUS_UPDATED actor_display: type: string description: >- Lesbare Autorenbezeichnung, aufgelöst in folgender Reihenfolge: vollständiger Name des Akteurs → Kennung des Console-Kontos → lokaler Teil von `actor_email` → `"API Client"` (für `API_KEY`-Akteure) → `"System"` (für `SYSTEM`-Akteure) → `"Unknown"`. Über `POST …/reviews/` erstellte Einträge zeigen immer `"Unknown"` an, da dieser Endpoint keine Akteurzuordnung erfasst. example: API Client actor_email: type: string nullable: true description: >- E-Mail des Console-Benutzers, der die Aktion ausgeführt hat. `null` für API-Schlüssel- und System-Akteure. example: null actor_type: type: string enum: - API_KEY - CONSOLE_USER - SYSTEM description: >- Wer die Aktion durchgeführt hat: ein API-Schlüssel, ein Benutzer der Konsole oder Didit selbst (`SYSTEM`, z. B. laufende AML-Überwachung). Über `POST …/reviews/` erstellte Einträge erhalten unabhängig vom Aufrufer den Standardwert `CONSOLE_USER`. example: API_KEY new_status: type: string nullable: true enum: - Not Started - In Progress - Approved - Declined - In Review - Expired - Abandoned - Kyc Expired - Resubmitted - Awaiting User description: >- Durch diesen Eintrag erfasster Sitzungsstatus (für Statusaktualisierungen). `null` bei Kommentaren und Datenänderungseinträgen. example: Approved previous_status: type: string nullable: true enum: - Not Started - In Progress - Approved - Declined - In Review - Expired - Abandoned - Kyc Expired - Resubmitted - Awaiting User description: >- Status, den die Sitzung vor der Änderung hatte. Ausgefüllt bei `STATUS_UPDATED`-Einträgen, die vom Update-Status-Endpoint geschrieben wurden; `null` bei Einträgen, die über `POST …/reviews/` hinzugefügt wurden. Auch bei systemgenerierten STATUS_UPDATED-Zeilen ausgefüllt. example: In Review comment: type: string nullable: true description: An den Eintrag angehängte Freitext-Notiz oder `null`. example: Document re-checked manually; address matches. mentioned_emails: type: array items: type: string format: email description: >- Console-Benutzer, die im Kommentar per `@email` erwähnt wurden. Immer leer für Einträge, die über diese API erstellt wurden – die Verarbeitung von Erwähnungen ist eine reine Console-Funktion. example: [] previous_value: type: object nullable: true description: >- Snapshot der geänderten Daten vor der Aktion, z. B. `{"status": "In Review"}` bei einer Statusänderung. `null`, wenn nichts geändert wurde. example: status: In Review new_value: type: object nullable: true description: >- Snapshot der geänderten Daten nach der Aktion, z. B. `{"status": "Approved"}`. `null`, wenn nichts geändert wurde. example: status: Approved changed_fields: type: array items: type: string description: >- Namen der durch diese Aktivität geänderten Felder (z. B. `["status"]`). Leer bei Kommentaren und bei Einträgen, die über `POST …/reviews/` hinzugefügt wurden. example: - status metadata: type: object nullable: true description: >- Zusätzlicher Kontext für systemgenerierte Einträge. Detailseitenaufrufe in der Console enthalten `{"system_event": "DETAIL_VIEWED", "detail_type": "verification"}`, damit sie aus der Benachrichtigungslogik herausgefiltert werden können. Ein `COMMENT`, der vom Autor in der Console bearbeitet wurde, enthält `edited_at`, den ISO-8601-Zeitstempel der letzten Bearbeitung (`comment` und `mentioned_emails` enthalten dann den bearbeiteten Text und die Erwähnungen). `null` bei gewöhnlichen Einträgen. example: null created_at: type: string format: date-time description: Wann der Eintrag geschrieben wurde, ISO 8601 UTC. example: '2026-06-12T00:19:31.918735Z' securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- 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. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.