> ## 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：ステップのステータス履歴

> Diditのセッションで、1つのステップのステータスに対するすべてのオーバーライドを新しい順に一覧表示します。状態は適用済み、本人のフロー完了待ち、キャンセル済みのいずれかです。



機能オーバーライド一覧取得のプロンプト
        プロンプトをクリップボードにコピー



      
      

\<pre>

\`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/<SESSION_ID>/features/overrides/ \
-H "x-api-key: <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.`

\</pre>



      
      

貼り付け先

[Update Feature Status](https://docs.didit.me/ja/sessions-api/update-feature-status.md)を呼び出すたびに、1つのチェックのステータスに対するオーバーライドが記録されます。
このエンドポイントは、1つのセッションのオーバーライドをすべて新しい順に、ページネーションなしで一覧表示します。## オーバーライドの状態| `state` | 意味 |
| - | - |
| `applied` | チェックに新しいステータスが反映されています。反映日時は`applied_at`で確認できます。 |
| `pending_until_flow_finishes` | オーバーライドは待機中で、本人がフローを完了した時点で反映されます。 |
| `cancelled` | オーバーライドは待機したまま反映されませんでした。理由は`cancel_reason`で確認できます。 |`forced: true`のオーバーライドは、本人がまだフローの途中であっても即座に反映されています。## 待機中のオーバーライドがキャンセルされた理由| `cancel_reason` | 発生した内容 |
| - | - |
| `cancelled_by_reviewer` | 誰かが[Cancel Feature Override](https://docs.didit.me/ja/sessions-api/cancel-feature-override.md)でキャンセルしました。 |
| `replaced` | 同じチェックに対する新しいオーバーライドに置き換えられました。 |
| `check_changed` | 本人がフローを完了する前にチェックをやり直したため、オーバーライドした結果が存在しなくなりました。 |
| `session_closed` | 本人がフローを完了する前に、セッションがフローから離脱しました。放棄、期限切れ、またはフローの途中での判定が該当します。 |## フロー内での本人の状況`person_in_flow`は、セッションが`Not Started`、`In Progress`または`Resubmitted`であり、本人がまだフローを完了していない間は`true`になります。
`true`の間は、`defer_until_flow_finishes: true`を指定した新しいオーバーライドは待機状態になります。
`flow_finished_at`は、本人が最後にフローを完了した日時です。
本人がまだフローの途中にいる間(再提出中を含む)、および本人が完了する前にセッションが終了した場合は`null`になります。## 関連項目- [Update Feature Status](https://docs.didit.me/ja/sessions-api/update-feature-status.md):1つのステップのステータスを、即座に、またはフローの完了時にオーバーライドします。
- [Cancel Feature Override](https://docs.didit.me/ja/sessions-api/cancel-feature-override.md):待機中のオーバーライドが反映されないようにします。
- [Retrieve Session](https://docs.didit.me/ja/sessions-api/retrieve-session.md):各機能の`node_id`と現在のステータスを取得します。


## OpenAPI

````yaml ja/openapi-25.json GET /v3/session/{sessionId}/features/overrides/
openapi: 3.0.0
info:
  version: 3.0.0
  title: Didit Verification API
  description: 本人確認API。x-api-keyヘッダーで認証します。
servers:
  - url: https://verification.didit.me
security: []
tags: []
paths:
  /v3/session/{sessionId}/features/overrides/:
    get:
      tags:
        - Sessions
      summary: セッションのチェックのオーバーライド一覧を取得
      description: >-
        ユーザー認証 (KYC) または法人確認 (KYB)
        セッションにおける個々の機能(ステップ)のステータスに対するすべてのオーバーライドを、新しい順に、ページネーションなしで返します。適用済みのもの、本人がフローを完了するのを待っているもの(`pending_until_flow_finishes`)、キャンセルされたものが含まれ、それぞれに依頼者、理由、および本人がまだフロー中に適用されたかどうか(`forced`)が含まれます。


        `person_in_flow`は、`defer_until_flow_finishes:
        true`を指定した新しいオーバーライドが待機状態になるかどうかを示します。`flow_finished_at`は本人が最後にフローを完了した日時です。本人がまだフロー中の場合(再提出を含む)や、本人が完了する前にセッションが終了した場合は`null`になります。


        `read:sessions`権限が必要です。スコープ付きAPIキーには判定への読み取りアクセスが必要です。
      operationId: get_v3_session_feature_overrides
      parameters:
        - in: path
          name: sessionId
          required: true
          description: 検証セッションのUUID。ユーザー(KYC)と企業(KYB)の両方のセッションIDを受け付けます。
          schema:
            type: string
            format: uuid
            example: 3fa85f64-5717-4562-b3fc-2c963f66afa6
      responses:
        '200':
          description: セッションのチェックのオーバーライド。新しい順。
          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: >-
                      本人がまだフロー内にいるかどうか。この場合、`defer_until_flow_finishes:
                      true`を指定した新しいオーバーライドは待機します。
                    example: true
                  flow_finished_at:
                    type: string
                    format: date-time
                    nullable: true
                    description: >-
                      本人が最後にフローを完了した日時。本人がまだフローの途中にいる間（再提出を含む）、および本人が完了する前にセッションが終了した場合（放棄、期限切れ、またはフロー途中での判定）は`null`です。
                    example: null
                  overrides:
                    type: array
                    description: セッションのすべてのオーバーライドを新しい順に示します。
                    items:
                      $ref: '#/components/schemas/FeatureStatusOverride'
              examples:
                Overrides:
                  summary: 上書き1件が待機中、1件が適用済み
                  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: スコープ付きAPIキーの有効期限が切れています。
          content:
            application/json:
              examples:
                Expired API Key:
                  summary: 有効期限を過ぎたスコープ付きAPIキー
                  value:
                    detail: This API key has expired.
        '403':
          description: >-
            認証情報がない、呼び出し元に`read:sessions`権限がない、スコープ付きAPIキーにこのエンドポイントに必要なアクセス権がない、または`session_id`が別のアプリケーションに属しています。
          content:
            application/json:
              examples:
                Invalid Credentials:
                  summary: x-api-keyがないか無効です
                  value:
                    detail: >-
                      Authentication credentials were not provided or are
                      invalid.
                Missing Privilege:
                  summary: 呼び出し元にread:sessions権限がありません
                  value:
                    detail: You do not have permission to perform this action.
                Scoped Key Without Access:
                  summary: このアクセス権を持たないスコープ付きAPIキー
                  value:
                    detail: This API key has no read access to decisions.
        '404':
          description: この`session_id`を持つKYCまたはKYBセッションが存在しません。
          content:
            application/json:
              examples:
                Not Found:
                  summary: 不明なsession_id
                  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: >-
            <?php


            require 'vendor/autoload.php';


            use Didit\DiditClient;


            // Reads DIDIT_API_KEY.

            $didit = new DiditClient();


            $result =
            $didit->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: >-
        `PATCH
        /v3/session/{sessionId}/features/{nodeId}/update-status/`で行ったチェック（機能）ステータスの上書き1件です。何を変更するか、適用済みか、まだ本人がフローを完了するのを待っているか、誰がなぜ依頼したかを示します。
      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: オーバーライドの識別子。キャンセル用エンドポイントに渡してください。
          example: 7c9e6679-7425-40de-944b-e07fc1f90ae7
        node_id:
          type: string
          description: リクエストで指定されたワークフローのノード(ノードのないステップの場合は`default`)。
          example: feature_ocr_1
        feature_type:
          type: string
          description: リクエストで渡された`feature_type`です。何も渡されなかった場合は空文字列です。
          example: ''
        feature_model:
          type: string
          description: オーバーライドされたチェックの種類です。例：`KYC`、`Face`、`AML`、`GeolocationCheck`。
          example: KYC
        previous_status:
          type: string
          enum:
            - Not Finished
            - Approved
            - Declined
            - In Review
            - Resub Requested
          description: オーバーライドがリクエストされた時点のチェックのステータス。
          example: In Review
        new_status:
          type: string
          enum:
            - Approved
            - Declined
            - In Review
          description: オーバーライドが設定するステータス。
          example: Approved
        state:
          type: string
          enum:
            - applied
            - pending_until_flow_finishes
            - cancelled
          description: >-
            `applied`：チェックに新しいステータスが適用されています。`pending_until_flow_finishes`：上書きは待機し、本人がフローを完了した時点で適用されます。`cancelled`：待機したものの、適用されることはありませんでした（`cancel_reason`を参照）。
          example: applied
        forced:
          type: boolean
          description: 本人がまだフロー内にいる間にオーバーライドが即座に適用された場合は`true`です。
          example: false
        reason:
          type: string
          nullable: true
          description: リクエストとともに送信された`comment`、または`null`です。
          example: Document manually verified by compliance.
        requested_by:
          type: object
          nullable: true
          description: オーバーライドを要求した者です。不明な場合は`null`です。
          properties:
            email:
              type: string
              format: email
              nullable: true
              description: コンソールユーザーのメールアドレス。APIキーおよびシステムの場合は`null`。
              example: reviewer@example.com
            name:
              type: string
              nullable: true
              description: リクエスト者の表示名、または`null`です。
              example: Alex Reviewer
            type:
              type: string
              enum:
                - CONSOLE_USER
                - API_KEY
                - SYSTEM
              description: リクエストを行った主体：コンソールユーザー、APIキー、またはDidit自身。
              example: CONSOLE_USER
        requested_at:
          type: string
          format: date-time
          description: オーバーライドがリクエストされた日時。
          example: '2026-10-13T09:15:00Z'
        applied_at:
          type: string
          format: date-time
          nullable: true
          description: チェックが新しいステータスになった日時。待機中、またはキャンセルされた後は`null`。
          example: '2026-10-13T09:15:00Z'
        cancelled_at:
          type: string
          format: date-time
          nullable: true
          description: 待機中のオーバーライドがキャンセルされた日時、または`null`。
          example: null
        cancel_reason:
          type: string
          nullable: true
          enum:
            - cancelled_by_reviewer
            - replaced
            - check_changed
            - session_closed
            - null
          description: >-
            待機中のオーバーライドが適用されなかった理由、または`null`。`cancelled_by_reviewer`：キャンセル用エンドポイントでキャンセルされました。`replaced`：同じチェックに対する新しいオーバーライドに置き換えられました。`check_changed`：本人がフローを完了する前にチェックをやり直しました。`session_closed`：本人がフローを完了する前に、セッションがフローを離れました（放棄、期限切れ、またはフロー途中での判定）。
          example: null
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        お客様のアプリケーションのAPIキーです。Business ConsoleのDevelopers -> API
        keysで取得できます。プライマリキーはフルアクセス権を持ちます。名前付きキーにはスコープを設定できます。リソースごとのアクセス権（なし、読み取り、書き込み）、一部のワークフローまたは承認済みセッションへの限定、IPアドレスのリストへの限定、有効期限の設定です。401は、キーが誤っている、失効している、または期限切れであることを意味します。403は、キーが送信されていない、キーにこのリソースやアクションへのアクセス権がない、またはIPリスト外のアドレスからリクエストが送信されたことを意味します。セッションのルートでの404は、セッションがキーのワークフローまたはステータスの対象外であることを意味します。メディアへのアクセス権がないキーでは、画像、動画、PDFのURLがnullで返されます。セッションの書き込み権限がないキーでは、セッションのリンクとトークンがnullで返されます。詳細は次を参照してください:
        https://docs.didit.me/console/api-keys

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.