> ## 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. # API elenco override funzionalità: storico stato passaggi > Con Didit elenchi ogni override dello stato di un passaggio su una sessione, dal più recente: applicato, in attesa del completamento o annullato. Prompt per elencare gli override delle funzionalità Copia il prompt negli appunti \

\`List the check (feature) status overrides of a Didit session: the ones that applied, the ones still waiting for the person to finish the flow, and the cancelled ones.

Endpoint:
GET https://verification.didit.me/v3/session/{session_id}/features/overrides/

Authentication:
x-api-key (client API key) or a user-auth token. Privilege: read:sessions. A scoped API key needs read access to decisions.

Path parameter:
\- session_id (UUID): KYC or KYB; Didit resolves it against both session types.

Response (200, not paginated):
\- session_id (UUID).
\- person_in_flow (boolean): true while the person is still in the flow, so a new override with defer_until_flow_finishes=true would wait.
\- flow_finished_at (date-time or null): when the person last finished the flow. null while they are still in it (a resubmission included) and when the session closed before they finished.
\- overrides (array, newest first). Each override:
\- id (UUID): pass it to the cancel endpoint.
\- node_id, feature_type ("" when the request passed none), feature_model (for example "KYC", "Face", "AML").
\- previous_status, new_status.
\- state: "applied", "pending_until_flow_finishes" or "cancelled".
\- forced (boolean): true when it applied at once while the person was still in the flow.
\- reason: the comment sent with the request, or null.
\- requested_by: { email, name, type } with type "CONSOLE_USER", "API_KEY" or "SYSTEM"; or null.
\- requested_at, applied_at (null while waiting or once cancelled), cancelled_at.
\- cancel_reason: null, "cancelled_by_reviewer", "replaced", "check_changed" or "session_closed".

curl example:
curl https://verification.didit.me/v3/session//features/overrides/ \
-H "x-api-key: "

Failure modes:
\- 401: the scoped API key has expired.
\- 403: missing credentials (a wrong, revoked or expired key gets 401), the caller lacks read:sessions, a scoped key lacks decisions read, or the session belongs to another application ({ "detail": "You do not have permission to perform this action." }).
\- 404: { "detail": "Not found." } when no session with this session_id exists.

Related: create overrides with PATCH /v3/session/{session_id}/features/{node_id}/update-status/ (see /sessions-api/update-feature-status); cancel a waiting one with POST /v3/session/{session_id}/features/overrides/{override_id}/cancel/ (see /sessions-api/cancel-feature-override).

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

\
Incolla in Ogni chiamata a [Update Feature Status](https://docs.didit.me/it/sessions-api/update-feature-status.md) registra un override dello stato di un controllo. Questo endpoint elenca tutti gli override di una sessione, dal più recente al più vecchio, senza paginazione.## Stati dell'override| `state` | Significato | | - | - | | `applied` | Il controllo ha il nuovo stato. `applied_at` indica quando. | | `pending_until_flow_finishes` | L'override resta in attesa e viene applicato quando la persona completa il flusso. | | `cancelled` | L'override era in attesa e non è mai stato applicato. `cancel_reason` indica il motivo. |Un override con `forced: true` è stato applicato subito, mentre la persona era ancora nel flusso.## Perché un override in attesa è stato annullato| `cancel_reason` | Cosa è successo | | - | - | | `cancelled_by_reviewer` | Qualcuno lo ha annullato con [Cancel Feature Override](https://docs.didit.me/it/sessions-api/cancel-feature-override.md). | | `replaced` | Un override più recente sullo stesso controllo lo ha sostituito. | | `check_changed` | La persona ha rifatto il controllo prima di completare il flusso, quindi il risultato che hai sovrascritto non esiste più. | | `session_closed` | La sessione ha lasciato il flusso prima che la persona lo completasse: è stata abbandonata, è scaduta oppure è stata presa una decisione durante il flusso. |## Dove si trova la persona nel flusso`person_in_flow` è `true` mentre la sessione è `Not Started`, `In Progress` o `Resubmitted` e la persona non ha ancora completato il flusso. Mentre è `true`, un nuovo override con `defer_until_flow_finishes: true` resta in attesa. `flow_finished_at` indica il momento in cui la persona ha completato il flusso per l'ultima volta. È `null` mentre la persona è ancora nel flusso, anche in caso di reinvio, e quando la sessione si è chiusa prima che lei lo completasse.## Correlati- [Update Feature Status](https://docs.didit.me/it/sessions-api/update-feature-status.md): sovrascrivi lo stato di un passaggio, subito o al termine del flusso. - [Cancel Feature Override](https://docs.didit.me/it/sessions-api/cancel-feature-override.md): impedisci che un override in attesa venga applicato. - [Retrieve Session](https://docs.didit.me/it/sessions-api/retrieve-session.md): il `node_id` e lo stato attuale di ogni funzionalità. ## OpenAPI ````yaml it/openapi-25.json GET /v3/session/{sessionId}/features/overrides/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API di verifica dell'identità. Autenticati con l'intestazione x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/session/{sessionId}/features/overrides/: get: tags: - Sessions summary: Elenca gli override dei controlli di una sessione description: >- Ogni override dello stato di una singola funzionalità (passaggio) in una sessione di Verifica degli utenti (KYC) o Verifica aziendale (KYB), dalla più recente alla più vecchia e senza paginazione: quelle applicate, quelle in attesa che la persona completi il flusso (`pending_until_flow_finishes`) e quelle annullate, ciascuna con l'indicazione di chi l'ha richiesta, il motivo e se è stata applicata mentre la persona era ancora nel flusso (`forced`). `person_in_flow` indica se un nuovo override con `defer_until_flow_finishes: true` rimarrebbe in attesa. `flow_finished_at` indica quando la persona ha completato l'ultima volta il flusso; è `null` se è ancora al suo interno (incluso un nuovo invio) e se la sessione si è chiusa prima del completamento. Richiede il privilegio `read:sessions`; una chiave API con ambito limitato necessita dell'accesso in lettura alle decisioni. operationId: get_v3_session_feature_overrides parameters: - in: path name: sessionId required: true description: >- UUID della sessione di verifica. Accetta sia ID di sessione utente (KYC) sia ID di sessione aziendale (KYB). schema: type: string format: uuid example: 3fa85f64-5717-4562-b3fc-2c963f66afa6 responses: '200': description: >- Gli override dei controlli della sessione, dal più recente al meno recente. content: application/json: schema: type: object required: - session_id - person_in_flow - flow_finished_at - overrides properties: session_id: type: string format: uuid example: 3fa85f64-5717-4562-b3fc-2c963f66afa6 person_in_flow: type: boolean description: >- Indica se la persona si trova ancora nel flusso, in modo che un nuovo override con `defer_until_flow_finishes: true` rimanga in attesa. example: true flow_finished_at: type: string format: date-time nullable: true description: >- Quando la persona ha completato l'ultima volta il flusso. `null` mentre si trova ancora al suo interno (incluso un nuovo invio) e quando la sessione si è chiusa prima del completamento (abbandonata, scaduta o sottoposta a una decisione a metà flusso). example: null overrides: type: array description: >- Ogni override della sessione, dal più recente al più vecchio. items: $ref: '#/components/schemas/FeatureStatusOverride' examples: Overrides: summary: Un override in attesa, uno applicato value: session_id: 3fa85f64-5717-4562-b3fc-2c963f66afa6 person_in_flow: true flow_finished_at: null overrides: - id: 9b2f4c1e-8d3a-4e5f-a6b7-c8d9e0f1a2b3 node_id: feature_liveness_1 feature_type: '' feature_model: Face previous_status: Declined new_status: Approved state: pending_until_flow_finishes forced: false reason: Liveness retried with a reviewer present. requested_by: email: reviewer@example.com name: Alex Reviewer type: CONSOLE_USER requested_at: '2026-10-13T09:15:00Z' applied_at: null cancelled_at: null cancel_reason: null - id: 7c9e6679-7425-40de-944b-e07fc1f90ae7 node_id: feature_ocr_1 feature_type: '' feature_model: KYC previous_status: In Review new_status: Approved state: applied forced: true reason: Document manually verified by compliance. requested_by: email: reviewer@example.com name: Alex Reviewer type: CONSOLE_USER requested_at: '2026-10-13T09:15:00Z' applied_at: '2026-10-13T09:15:00Z' cancelled_at: null cancel_reason: null '401': description: La chiave API con ambito è scaduta. content: application/json: examples: Expired API Key: summary: Chiave API con ambito oltre la sua data di scadenza value: detail: This API key has expired. '403': description: >- Credenziali mancanti, chiamante senza il privilegio `read:sessions`, chiave API con ambito limitato priva dell'accesso richiesto da questo endpoint, oppure un `session_id` che appartiene a un'altra applicazione. content: application/json: examples: Invalid Credentials: summary: x-api-key mancante o non valida value: detail: >- Authentication credentials were not provided or are invalid. Missing Privilege: summary: Il chiamante non dispone dell'autorizzazione read:sessions value: detail: You do not have permission to perform this action. Scoped Key Without Access: summary: Chiave API con ambito priva di questo accesso value: detail: This API key has no read access to decisions. '404': description: Non esiste alcuna sessione KYC o KYB con questo `session_id`. content: application/json: examples: Not Found: summary: session_id sconosciuto value: detail: Not found. security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: |- curl -X GET \ https://verification.didit.me/v3/session/3fa85f64-5717-4562-b3fc-2c963f66afa6/features/overrides/ \ -H 'x-api-key: YOUR_API_KEY' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.sessions.list_feature_overrides( "3fa85f64-5717-4562-b3fc-2c963f66afa6", ) print(result) - lang: javascript label: Node.js source: >- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); const result = await didit.sessions.listFeatureOverrides("3fa85f64-5717-4562-b3fc-2c963f66afa6"); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.Sessions.ListFeatureOverrides(ctx, \"3fa85f64-5717-4562-b3fc-2c963f66afa6\")\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: >- import me.didit.Didit; // Reads DIDIT_API_KEY. Didit client = new Didit(); var result = client.sessions().listFeatureOverrides("3fa85f64-5717-4562-b3fc-2c963f66afa6"); System.out.println(result); - lang: php label: PHP source: >- sessions->listFeatureOverrides('3fa85f64-5717-4562-b3fc-2c963f66afa6'); print_r($result->toArray()); - lang: ruby label: Ruby source: >- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.sessions.list_feature_overrides("3fa85f64-5717-4562-b3fc-2c963f66afa6") puts result.to_h - lang: csharp label: .NET source: >- using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); var result = await client.Sessions.ListFeatureOverridesAsync("3fa85f64-5717-4562-b3fc-2c963f66afa6"); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: FeatureStatusOverride: type: object description: >- Un override dello stato di un controllo (funzionalità) eseguito con `PATCH /v3/session/{sessionId}/features/{nodeId}/update-status/`: cosa modifica, se è stato applicato o è ancora in attesa che la persona completi il flusso, chi lo ha richiesto e perché. required: - id - node_id - feature_type - feature_model - previous_status - new_status - state - forced - reason - requested_by - requested_at - applied_at - cancelled_at - cancel_reason properties: id: type: string format: uuid description: Identificatore dell'override. Passalo all'endpoint di annullamento. example: 7c9e6679-7425-40de-944b-e07fc1f90ae7 node_id: type: string description: >- Il nodo del workflow indicato dalla richiesta (`default` per un passaggio privo di nodo). example: feature_ocr_1 feature_type: type: string description: >- Il `feature_type` passato dalla richiesta, oppure una stringa vuota se non ne è stato passato alcuno. example: '' feature_model: type: string description: >- Il tipo di controllo che è stato ignorato manualmente, ad esempio `KYC`, `Face`, `AML` o `GeolocationCheck`. example: KYC previous_status: type: string enum: - Not Finished - Approved - Declined - In Review - Resub Requested description: Lo stato del controllo al momento della richiesta dell'override. example: In Review new_status: type: string enum: - Approved - Declined - In Review description: Lo stato impostato dall'override. example: Approved state: type: string enum: - applied - pending_until_flow_finishes - cancelled description: >- `applied`: il controllo ha il nuovo stato. `pending_until_flow_finishes`: l'override resta in attesa e viene applicato quando la persona completa il flusso. `cancelled`: è rimasto in attesa e non è mai stato applicato (vedi `cancel_reason`). example: applied forced: type: boolean description: >- `true` quando l'override è stato applicato immediatamente mentre la persona si trovava ancora nel flusso. example: false reason: type: string nullable: true description: Il `comment` inviato con la richiesta, oppure `null`. example: Document manually verified by compliance. requested_by: type: object nullable: true description: Chi ha richiesto l'override, o `null` quando non è noto. properties: email: type: string format: email nullable: true description: >- Email dell'utente della console, oppure `null` per le chiavi API e il sistema. example: reviewer@example.com name: type: string nullable: true description: Nome visualizzato del richiedente, oppure `null`. example: Alex Reviewer type: type: string enum: - CONSOLE_USER - API_KEY - SYSTEM description: >- Chi ha effettuato la richiesta: un utente della console, una chiave API o Didit stessa. example: CONSOLE_USER requested_at: type: string format: date-time description: Quando è stato richiesto l'override. example: '2026-10-13T09:15:00Z' applied_at: type: string format: date-time nullable: true description: >- Data e ora in cui il controllo ha assunto il nuovo stato, oppure `null` mentre è in attesa o una volta annullato. example: '2026-10-13T09:15:00Z' cancelled_at: type: string format: date-time nullable: true description: Quando un override in attesa è stato annullato, oppure `null`. example: null cancel_reason: type: string nullable: true enum: - cancelled_by_reviewer - replaced - check_changed - session_closed - null description: >- Il motivo per cui un override in attesa non è mai stato applicato, oppure `null`. `cancelled_by_reviewer`: annullato con l'endpoint di annullamento. `replaced`: sostituito da un override più recente sullo stesso controllo. `check_changed`: la persona ha ripetuto il controllo prima di completare il flusso. `session_closed`: la sessione è uscita dal flusso prima che la persona lo completasse (abbandonata, scaduta o decisa a metà flusso). example: null securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- 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. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.