> ## 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 Management APIでモニタリングイベント1件を取得します。ペイロード、デバイス情報、IPエンリッチメント、キャッシュ済みのサブジェクトシグナル、タグ、ルールの根拠を返します。

モニタリングイベント取得APIプロンプト
プロンプトをクリップボードにコピー

<pre>
  \`Retrieve one monitoring event from Didit with its full envelope, enrichment and rule evidence.

  Endpoint:
  GET [https://verification.didit.me/v3/events/\{event\_uuid}/](https://verification.didit.me/v3/events/\{event_uuid}/)

  Authentication:
  Use the x-api-key header with my Didit API key. A scoped key needs transactions: read.

  Goal:

  * Show the event detail in my back office or an investigation tool: what was sent, what Didit derived, and why a rule matched.

  Behavior:

  * event\_uuid is the Didit id returned by the create, batch, list and timeline calls (not my own event\_id).
  * Returns every summary field of the list call plus payload, custom\_values, device\_context, field\_sources, the promoted domain fields (hand\_id, dispute\_id, chargeback\_id, withdrawal\_address\_hash, changed\_field, ...), expires\_at, rules\_evaluated\_count, rule\_runs, ip\_enrichment, subject\_profile and tags.
  * field\_sources maps each field path to customer (sent by my backend), sdk (sent by the device lane) or server (derived by Didit, such as received\_at and IP enrichment).
  * While correlation\_pending is true an asynchronous rule still has to run; read the event again later for the final status, score and rule\_runs.
  * ip\_enrichment and subject\_profile are null when nothing is known.

  Example call:
  curl -X GET "[https://verification.didit.me/v3/events/11111111-2222-3333-4444-555555555555/](https://verification.didit.me/v3/events/11111111-2222-3333-4444-555555555555/)" \
  -H "x-api-key: YOUR\_API\_KEY"

  What to read from the response:

  * status, score, rules\_matched\_count.
  * rule\_runs\[] - one per matching rule: rule\_uuid, rule\_title, library\_key, mode (ACTIVE or TEST), severity, matched (always true), score\_delta, action\_summary, is\_async, matched\_payload (the conditions and aggregations that matched, with expected and observed values) and created\_at.
  * ip\_enrichment - ip\_country\_code, ip\_city, asn\_number, asn\_organization, is\_vpn\_or\_tor, is\_data\_center, proxy\_type, last\_enriched\_at.
  * field\_sources - trust signal for each value before acting on a match.
  * tags - names of the tags rules attached.

  Failure modes:

  * 401 - the API key has expired.
  * 403 - missing API key (a wrong, revoked or expired key gets 401), or a scoped key without transactions: read.
  * 404 - no event with this event\_uuid in the application (never stored, deleted, or another application's).

  Side effects: none. This is a pure read.

  For the full integration shape, see /integration/integration-prompt.\`
</pre>

貼り付け先

ルールの実行で一致した各値とその取得元がどのように記録されるかは[エビデンス](https://docs.didit.me/ja/transaction-monitoring/event-rules.md#エビデンス)を、拡充されたIPアドレスフィールドについては[IPエンリッチメント](https://docs.didit.me/ja/transaction-monitoring/ip-enrichment.md)を参照してください。


## OpenAPI

````yaml ja/openapi-25.json GET /v3/events/{event_uuid}/
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/events/{event_uuid}/:
    get:
      tags:
        - Monitoring Events
      summary: モニタリングイベントを取得
      description: >-
        1件のモニタリングイベントを取得します。一覧で返される内容すべてに加え、ペイロード、カスタム値、デバイスコンテキスト、フィールドの出所（`field_sources`）、昇格されたドメインフィールド、`expires_at`、一致したすべてのルール実行とそのエビデンス、IPエンリッチメント、ルールが付与したタグが含まれます。`correlation_pending`が`true`の間は、非同期ルールがまだ実行されていません。数分後にイベントを再度読み取り、最終的な`status`、`score`、`rule_runs`を確認してください。読み取りは、イベント取り込みが有効かどうかにかかわらず機能します。スコープ付きAPIキーには`transactions:
        read`が必要です。[エビデンス](https://docs.didit.me/ja/transaction-monitoring/event-rules#エビデンス)と[IPエンリッチメント](https://docs.didit.me/ja/transaction-monitoring/ip-enrichment)を参照してください。
      operationId: get_monitoring_event
      parameters:
        - name: event_uuid
          in: path
          required: true
          description: >-
            イベントのDidit識別子（作成、一括、一覧、またはタイムラインのレスポンスに含まれる`event_uuid`）で、独自の`event_id`ではありません。
          schema:
            type: string
            format: uuid
          example: 11111111-2222-3333-4444-555555555555
      responses:
        '200':
          description: 証拠を含むイベントです。
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MonitoringEventDetail'
              examples:
                Login from a VPN, in review:
                  value:
                    event_uuid: 33333333-4444-5555-6666-777777777777
                    event_id: login-2026-10-17-000001
                    event_category: auth
                    action_type: login
                    occurred_at: '2026-10-17T09:15:02.481000Z'
                    received_at: '2026-10-17T09:15:02.903114Z'
                    status: IN_REVIEW
                    score: 40
                    subject_vendor_data: user-42
                    subject_entity_type: individual
                    subject_uuid: 66666666-7777-8888-9999-000000000000
                    counterparty_vendor_data: null
                    session_id: web-session-abc
                    device_fingerprint: fp-a8c1
                    ip_address: 203.0.113.42
                    ip_country: ES
                    amount: null
                    currency: null
                    game_id: null
                    round_id: null
                    bonus_id: null
                    affiliate_code: null
                    payment_reference_id: null
                    retention_class: risk_relevant
                    rules_matched_count: 1
                    correlation_pending: false
                    is_droppable: true
                    payload:
                      method: password
                    custom_values:
                      vip_tier: gold
                      vpn_or_proxy_detected: true
                    device_context:
                      fingerprint: fp-a8c1
                      network_context:
                        ip_address: 203.0.113.42
                        ip_country: Spain
                        ip_country_code: ES
                        ip_city: Madrid
                        asn_number: 64500
                        asn_organization: Example Networks
                        is_vpn_or_tor: true
                        is_data_center: false
                    field_sources:
                      subject.vendor_data: customer
                      event_category: customer
                      action_type: customer
                      occurred_at: customer
                      received_at: server
                      payload.method: customer
                      session.session_id: customer
                      session.sequence: customer
                      device_context.fingerprint: customer
                      device_context.network_context.ip_address: customer
                      device_context.network_context.ip_country: server
                      device_context.network_context.ip_country_code: server
                      device_context.network_context.ip_city: server
                      device_context.network_context.asn_number: server
                      device_context.network_context.asn_organization: server
                      device_context.network_context.is_vpn_or_tor: server
                      device_context.network_context.is_data_center: server
                    session_sequence: 142
                    table_id: null
                    hand_id: null
                    match_id: null
                    market_id: null
                    side: null
                    role: null
                    net_result_amount: null
                    payment_fingerprint: null
                    instrument_reference_hash: null
                    withdrawal_address_hash: null
                    dispute_id: null
                    chargeback_id: null
                    changed_field: null
                    identity_match_ref: null
                    schema_version: 1
                    expires_at: '2027-01-15T09:15:02.481000Z'
                    rules_evaluated_count: 6
                    rule_runs:
                      - rule_uuid: aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee
                        rule_title: Login from VPN or Tor
                        library_key: null
                        matched: true
                        mode: ACTIVE
                        is_async: false
                        severity: MEDIUM
                        score_delta: 40
                        action_summary: score +40; add_tag:VPN_LOGIN
                        matched_payload:
                          - field: event.ip.is_vpn_or_tor
                            operator: eq
                            expected_value: true
                            current_value: true
                            matched: true
                            group_index: null
                            group_logic: AND
                            field_source: server
                        created_at: '2026-10-17T09:15:02.951207Z'
                    ip_enrichment:
                      ip_country_code: ES
                      ip_city: Madrid
                      asn_number: 64500
                      asn_organization: Example Networks
                      is_vpn_or_tor: true
                      is_data_center: false
                      proxy_type: null
                      last_enriched_at: '2026-10-17T09:15:02.910442Z'
                    subject_profile: null
                    tags:
                      - VPN_LOGIN
        '401':
          description: >-
            スコープ付きAPIキーの有効期限が切れています。`401`が返されるのは期限切れのキーのみで、キーが指定されていない場合や無効な場合は`403`が返されます。
          content:
            application/json:
              examples:
                Expired key:
                  value:
                    detail: This API key has expired.
        '403':
          description: >-
            `x-api-key`がない（誤った、取り消された、または期限切れのキーには`401`が返されます）、`transactions:
            read`を持たないスコープ付きキー、一部のワークフローまたは承認済みセッションに限定されたキー（このようなキーはトランザクションモニタリングのデータに一切アクセスできません）、またはキーのIP許可リスト外からのリクエスト。
          content:
            application/json:
              examples:
                Missing or invalid API key:
                  value:
                    detail: You do not have permission to perform this action.
                Scoped key without access:
                  value:
                    detail: This API key has no read access to transactions.
                Key limited to workflows or approved sessions:
                  value:
                    detail: >-
                      This API key only reaches sessions inside its workflow or
                      status limits, so it can't use this endpoint.
                IP not allowed:
                  value:
                    detail: This API key can't be used from this IP address.
        '404':
          description: >-
            この`event_uuid`のイベントはアプリケーション内に存在しません。保存されていない、削除された、または別のアプリケーションに属しているかのいずれかです。UUIDではないパスセグメントはルートに一致せず、同じく`404`が返されます。
          content:
            application/json:
              examples:
                Not found:
                  value:
                    detail: No MonitoringEvent matches the given query.
        '429':
          description: >-
            レート制限を超過しました。`GET`リクエストは、APIキーごとに1分あたり600リクエストの上限を共有します。`Retry-After`秒待ってから再試行してください。
          headers:
            Retry-After:
              description: 再試行までに待機する秒数。
              schema:
                type: integer
                minimum: 1
                example: 30
          content:
            application/json:
              examples:
                Throttled:
                  value:
                    detail: >-
                      GET request rate limit exceeded. You can make up to 600
                      requests per minute.
      security:
        - ApiKeyAuth: []
      x-codeSamples:
        - lang: curl
          label: curl
          source: >-
            curl -X GET
            'https://verification.didit.me/v3/events/11111111-2222-3333-4444-555555555555/'
            \
              -H 'x-api-key: YOUR_API_KEY'
        - lang: python
          label: Python
          source: |-
            from didit import Didit

            # Reads DIDIT_API_KEY.
            client = Didit()

            result = client.monitoring_events.retrieve(
                "11111111-2222-3333-4444-555555555555",
            )
            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.monitoringEvents.retrieve("11111111-2222-3333-4444-555555555555");

            console.log(result);
        - lang: go
          label: Go
          source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.MonitoringEvents.Retrieve(ctx, \"11111111-2222-3333-4444-555555555555\")\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.monitoringEvents().retrieve("11111111-2222-3333-4444-555555555555");

            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->monitoringEvents->retrieve('11111111-2222-3333-4444-555555555555');

            print_r($result->toArray());
        - lang: ruby
          label: Ruby
          source: >-
            require "didit"


            # Reads DIDIT_API_KEY.

            didit = Didit::Client.new


            result =
            didit.monitoring_events.retrieve("11111111-2222-3333-4444-555555555555")

            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.MonitoringEvents.RetrieveAsync("11111111-2222-3333-4444-555555555555");

            Console.WriteLine(JsonSerializer.Serialize(result));
components:
  schemas:
    MonitoringEventDetail:
      description: >-
        完全なエンベロープ、エンリッチメント、ルールの根拠を含むモニタリングイベント1件。`MonitoringEvent`のすべてのフィールドに加えて、以下のフィールドを含みます。
      allOf:
        - $ref: '#/components/schemas/MonitoringEvent'
        - type: object
          required:
            - payload
            - custom_values
            - device_context
            - field_sources
            - session_sequence
            - table_id
            - hand_id
            - match_id
            - market_id
            - side
            - role
            - net_result_amount
            - payment_fingerprint
            - instrument_reference_hash
            - withdrawal_address_hash
            - dispute_id
            - chargeback_id
            - changed_field
            - identity_match_ref
            - schema_version
            - expires_at
            - rules_evaluated_count
            - rule_runs
            - ip_enrichment
            - subject_profile
            - tags
          properties:
            payload:
              type: object
              additionalProperties: true
              description: '`payload`で送信したカテゴリのフィールド。'
            custom_values:
              type: object
              additionalProperties: true
              description: >-
                送信したスカラー値の`custom_values`です。IPエンリッチメントでIPアドレスにフラグが付き、かつこれらの値を設定していない場合、Diditは`vpn_or_proxy_detected:
                true`または`is_data_center: true`を追加します。
            device_context:
              type: object
              additionalProperties: true
              description: >-
                保存されたデバイスコンテキストです。送信した`device_context`（送信した場合は`fingerprint`、`persistent_device_id`、`bot_score`を含む）に加え、空のままにしたキーについてはIPエンリッチメントで補完された`network_context`（`ip_country`、`ip_country_code`、`ip_city`、`asn_number`、`asn_organization`、`is_vpn_or_tor`、`is_data_center`、`proxy_type`、`connection_type`）が含まれます。
            field_sources:
              type: object
              additionalProperties:
                type: string
                enum:
                  - customer
                  - sdk
                  - server
              description: >-
                フィールドパスと提供元の対応:`customer`(バックエンドから送信)、`sdk`(デバイス経由で送信)、`server`(`received_at`やエンリッチされたネットワークフィールドなど、Diditが導出)。一致に基づいて対応する前に確認してください。
            session_sequence:
              type: integer
              format: int64
              nullable: true
              description: イベントとともに送信される`session.sequence`です。
            table_id:
              type: string
              nullable: true
              description: '`payload.table_id`から昇格した値です。'
              maxLength: 128
            hand_id:
              type: string
              nullable: true
              description: '`payload.hand_id`から昇格されたフィールドです。'
              maxLength: 128
            match_id:
              type: string
              nullable: true
              description: '`payload.match_id`から昇格した値です。'
              maxLength: 128
            market_id:
              type: string
              nullable: true
              description: '`payload.market_id`から昇格した値です。'
              maxLength: 128
            side:
              type: string
              nullable: true
              description: '`payload.side`から昇格した値です。'
              maxLength: 64
            role:
              type: string
              nullable: true
              description: '`payload.role`から昇格した値です。'
              maxLength: 64
            net_result_amount:
              type: string
              nullable: true
              description: '`payload.net_result_amount`から昇格した値で、小数点以下18桁の10進数文字列です。'
              example: '-120.000000000000000000'
            payment_fingerprint:
              type: string
              nullable: true
              description: '`payload.payment_fingerprint`から昇格した値です。'
              maxLength: 255
            instrument_reference_hash:
              type: string
              nullable: true
              description: '`payload.instrument_reference_hash`から昇格した値です。'
              maxLength: 255
            withdrawal_address_hash:
              type: string
              nullable: true
              description: >-
                `payload.withdrawal_address_hash`(または`payload.destination_reference_hash`)から昇格した値です。
              maxLength: 255
            dispute_id:
              type: string
              nullable: true
              description: '`payload.dispute_id`から昇格されたフィールドです。'
              maxLength: 255
            chargeback_id:
              type: string
              nullable: true
              description: '`payload.chargeback_id`から昇格されたフィールドです。'
              maxLength: 255
            changed_field:
              type: string
              nullable: true
              description: '`payload.changed_field`から昇格されたフィールドです（セキュリティ変更イベント）。'
              maxLength: 128
            identity_match_ref:
              type: string
              nullable: true
              description: '`payload.identity_match_ref`から昇格されたフィールドです（責任あるギャンブルのレジストリとの一致）。'
              maxLength: 255
            schema_version:
              type: integer
              description: イベントエンベロープのスキーマのバージョン。現在は`1`です。
              example: 1
            expires_at:
              type: string
              format: date-time
              nullable: true
              description: >-
                イベントが保持クラスに基づいて期限切れとなり、削除される日時で、`occurred_at`にクラスの期間（デフォルトで14日、30日、または90日。アプリケーションごとに調整可能）を加えた日時です。`monetary_or_compliance`イベントの場合はnullで、取引の保持期間に従います。
            rules_evaluated_count:
              type: integer
              minimum: 0
              description: このイベントに対して評価されたイベントルールの数。
            rule_runs:
              type: array
              description: イベントに一致したすべてのルールを新しい順に示します。
              items:
                $ref: '#/components/schemas/MonitoringEventRuleRun'
            ip_enrichment:
              type: object
              nullable: true
              description: >-
                イベントのIPアドレスの付加情報。アドレスに付加情報が追加されなかった場合はnullです。[IPエンリッチメント](https://docs.didit.me/ja/transaction-monitoring/ip-enrichment)を参照してください。
              properties:
                ip_country_code:
                  type: string
                  nullable: true
                  description: 住所の国コード。
                ip_city:
                  type: string
                  nullable: true
                  description: 住所の都市。
                asn_number:
                  type: integer
                  nullable: true
                  description: 自律システム番号。
                asn_organization:
                  type: string
                  nullable: true
                  description: 自律システムを運用する組織です。
                is_vpn_or_tor:
                  type: boolean
                  description: そのアドレスが既知のVPNまたはTorの出口かどうか。
                is_data_center:
                  type: boolean
                  description: そのアドレスがホスティングまたはデータセンターのネットワークに属しているかどうか。
                proxy_type:
                  type: string
                  nullable: true
                  description: アドレスのプロキシ分類を表す不透明な文字列、またはnullです。
                last_enriched_at:
                  type: string
                  format: date-time
                  nullable: true
                  description: アドレスが最後にエンリッチメントされた日時。
              required:
                - ip_country_code
                - ip_city
                - asn_number
                - asn_organization
                - is_vpn_or_tor
                - is_data_center
                - proxy_type
                - last_enriched_at
            subject_profile:
              type: object
              nullable: true
              description: 対象者についてキャッシュされたメールアドレスと電話番号のリスクシグナル。対象者のプロファイルが存在しない場合はnull。
              properties:
                email_risk_score:
                  type: integer
                  nullable: true
                  description: メールアドレスのリスクスコア。
                email_deliverability:
                  type: string
                  nullable: true
                  description: メールアドレスの到達性の判定。
                email_is_disposable:
                  type: boolean
                  nullable: true
                  description: メールアドレスが使い捨てかどうか。
                email_is_breached:
                  type: boolean
                  nullable: true
                  description: メールアドレスが既知のデータ漏えいに含まれているかどうか。
                email_social_count:
                  type: integer
                  nullable: true
                  description: メールアドレスに紐づくオンラインアカウントの数。
                email_social_providers:
                  type: array
                  items:
                    type: string
                  description: メールアドレスに紐づくアカウントが見つかったオンラインサービスの名前。
                phone_risk_score:
                  type: integer
                  nullable: true
                  description: 電話番号のリスクスコア。
                phone_line_type:
                  type: string
                  nullable: true
                  description: 電話回線の種類。
                phone_carrier:
                  type: string
                  nullable: true
                  description: 電話キャリア名。
                phone_social_count:
                  type: integer
                  nullable: true
                  description: 電話番号に紐づくオンラインアカウントの数。
                phone_social_providers:
                  type: array
                  items:
                    type: string
                  description: 電話番号に紐づくアカウントが見つかったオンラインサービスの名前。
                source_provider:
                  type: string
                  nullable: true
                  description: プロファイルの取得元を示す不透明な識別子です。
                last_enriched_at:
                  type: string
                  format: date-time
                  nullable: true
                  description: プロファイルが最後に更新された日時。
              required:
                - email_risk_score
                - email_deliverability
                - email_is_disposable
                - email_is_breached
                - email_social_count
                - email_social_providers
                - phone_risk_score
                - phone_line_type
                - phone_carrier
                - phone_social_count
                - phone_social_providers
                - source_provider
                - last_enriched_at
            tags:
              type: array
              items:
                type: string
              description: イベントに付与されたタグの名前（ルールの`add_tags`アクション）。
    MonitoringEvent:
      type: object
      description: >-
        一覧エンドポイントおよび対象者タイムラインエンドポイントが返す、保存済みのモニタリングイベント1件です。制限付きの証拠（ペイロード、デバイスコンテキスト、ルールの証拠）は`GET
        /v3/events/{event_uuid}/`でのみ返されます。
      required:
        - event_uuid
        - event_id
        - event_category
        - action_type
        - occurred_at
        - received_at
        - status
        - score
        - subject_vendor_data
        - subject_entity_type
        - subject_uuid
        - counterparty_vendor_data
        - session_id
        - device_fingerprint
        - ip_address
        - ip_country
        - amount
        - currency
        - game_id
        - round_id
        - bonus_id
        - affiliate_code
        - payment_reference_id
        - retention_class
        - rules_matched_count
        - correlation_pending
        - is_droppable
      properties:
        event_uuid:
          type: string
          format: uuid
          description: イベントのDidit識別子です。取得および削除の呼び出しで`{event_uuid}`として使用します。
        event_id:
          type: string
          maxLength: 128
          description: お客様独自の識別子で、送信した冪等性キーです。
        event_category:
          type: string
          enum:
            - auth
            - session
            - gameplay
            - bonus
            - affiliate
            - payment
            - dispute
            - security
            - responsible_gambling
            - custom
          description: イベントカテゴリー。
        action_type:
          type: string
          maxLength: 128
          description: カテゴリ内で発生した内容。送信したとおりの値です。
        occurred_at:
          type: string
          format: date-time
          description: お客様側でイベントが発生した日時。
        received_at:
          type: string
          format: date-time
          description: Diditがイベントを受け付けた日時です。
        status:
          type: string
          enum:
            - ACCEPTED
            - APPROVED
            - IN_REVIEW
            - DECLINED
          description: >-
            `ACCEPTED`：保存済みで、一致したルールによって状態が変わらなかったことを示します（大半のイベントでの通常の結果であり、ルールが実行されないサンドボックスアプリケーションでは常にこの結果になります）。`APPROVED`：ルールが一致し、スコアがレビューのしきい値未満にとどまりました。`IN_REVIEW`：ルールによってスコアがレビューのしきい値を超えたか、ルールがステータスを設定しました。`DECLINED`：ルールによって却下されたか、スコアが却下のしきい値を超えました。
        score:
          type: integer
          description: 累積ルールスコア。0から始まり、ルールの`add_score`アクションによって変動します（負の差分も使用できます）。
        subject_vendor_data:
          type: string
          maxLength: 255
          description: 'イベントの`subject.vendor_data`: ユーザーまたは企業を識別するお客様のIDです。'
        subject_entity_type:
          type: string
          description: '`individual`または`company`: `subject_vendor_data`が指す対象の種類。'
          example: individual
        subject_uuid:
          type: string
          format: uuid
          nullable: true
          description: イベントの解決先となったユーザー(個人)または企業のUUID。該当するレコードが存在しなくなった場合はnullです。
        counterparty_vendor_data:
          type: string
          nullable: true
          description: P2Pイベントのもう一方のプレイヤー（`payload.counterparty_vendor_data`から昇格）。
          maxLength: 255
        session_id:
          type: string
          nullable: true
          description: イベントとともに送信される`session.session_id`です。
          maxLength: 255
        device_fingerprint:
          type: string
          nullable: true
          description: イベントとともに送信された`device_context.fingerprint`。
          maxLength: 255
        ip_address:
          type: string
          nullable: true
          description: >-
            イベントのIPアドレス。サーバーレーンでは送信した`device_context.network_context.ip_address`の値そのもので、デバイスレーンではリクエストのIPです。
          maxLength: 64
        ip_country:
          type: string
          nullable: true
          description: >-
            IPエンリッチメントで得た`ip_address`の国コード。アドレスがエンリッチされなかった場合(欠落、プライベート、またはアドレスがまだ把握されていない低価値テレメトリ)はnullです。
          example: ES
        amount:
          type: string
          nullable: true
          description: >-
            小数点以下18桁の10進数文字列で表した金額。`transaction_context.amount`、`payload.amount`、`payload.stake_amount`の順に取得されます。
          example: '250.000000000000000000'
        currency:
          type: string
          nullable: true
          description: '`transaction_context.currency`または`payload.currency`から取得した通貨。'
          maxLength: 10
        game_id:
          type: string
          nullable: true
          description: '`payload.game_id`から昇格されたフィールドです。'
          maxLength: 128
        round_id:
          type: string
          nullable: true
          description: '`payload.round_id`から昇格した値です。'
          maxLength: 128
        bonus_id:
          type: string
          nullable: true
          description: '`payload.bonus_id`から昇格されたフィールドです。'
          maxLength: 128
        affiliate_code:
          type: string
          nullable: true
          description: '`payload.affiliate_code`から昇格されたフィールドです。'
          maxLength: 128
        payment_reference_id:
          type: string
          nullable: true
          description: >-
            `transaction_context.payment_reference_id`または`payload.payment_reference_id`から取得した支払い参照番号。
          maxLength: 255
        retention_class:
          type: string
          enum:
            - low_value
            - standard
            - risk_relevant
            - monetary_or_compliance
          description: >-
            保持クラス。支払いおよび異議申し立てのイベントは`monetary_or_compliance`、セキュリティおよび責任あるギャンブルのイベントは`risk_relevant`、`session.page_view`、`session.sdk_heartbeat`、`session.sdk_loaded`、`session.device_seen`、`session.bot_signal_observed`、`bonus.promotion_viewed`、`affiliate.referral_clicked`は`low_value`、それ以外はすべて`standard`です。有効なルールに一致したイベントは`risk_relevant`に昇格されます（降格されることはありません）。
        rules_matched_count:
          type: integer
          minimum: 0
          description: イベントに一致したルールの数です。`TEST`モードのルール（証跡を記録しますが、アクションは適用しません）も含みます。
        correlation_pending:
          type: boolean
          description: >-
            このイベントについて非同期ルール（対象者をまたぐ相関、または24時間を超えるシーケンス）がまだ実行待ちの間は`true`です。数分以内に解決し、`status`、`score`、`rules_matched_count`がその場で更新されます。
        is_droppable:
          type: boolean
          description: >-
            バックプレッシャー下のSDKがこの種類のイベントを破棄してよいかどうかです。すべての`security`、`payment`、`dispute`、`responsible_gambling`イベント、および`gameplay.bet_placed`、`gameplay.bet_settled`、`gameplay.p2p_settlement`では`false`です。
    MonitoringEventRuleRun:
      type: object
      properties:
        rule_uuid:
          type: string
          format: uuid
          description: トランザクションモニタリングルールのUUID。
        rule_title:
          type: string
          description: ルールのタイトル。
        library_key:
          type: string
          nullable: true
          description: ルールがルールライブラリからインストールされた場合はライブラリキー、それ以外の場合はnull。
        matched:
          type: boolean
          description: 常に`true`です。一致した実行のみが記録されます。
        mode:
          type: string
          enum:
            - ACTIVE
            - TEST
          description: ルール実行時のモード。`TEST`の実行では証拠が記録されますが、アクションは適用されていません。
        is_async:
          type: boolean
          description: 実行が取り込みリクエストではなく非同期の相関処理によるものである場合は`true`です。
        severity:
          type: string
          nullable: true
          enum:
            - UNKNOWN
            - LOW
            - MEDIUM
            - HIGH
            - CRITICAL
            - null
          description: ルールの重大度。`TEST`の実行時、および重大度のないルールではnullです。
        score_delta:
          type: integer
          description: この実行によってイベントのスコアが変化した量（`TEST`実行では0）。
        action_summary:
          type: string
          nullable: true
          description: 適用されたアクションの短い要約（例：`score +40; add_tag:VPN_LOGIN`）。何も適用されなかった場合はnull。
        matched_payload:
          type: array
          description: >-
            一致した条件と集計。条件のエントリには`field`、`operator`、`expected_value`、`current_value`、`matched`、`group_index`、`group_logic`、`field_source`(`server`、`sdk`または`customer`)が含まれます。集計のエントリには`metric`、`field`、`operator`、`expected_value`、`computed_value`、`window`、`filters`、`matched`、`sample_references`が含まれます。
          items:
            type: object
            additionalProperties: true
        created_at:
          type: string
          format: date-time
          description: ルールの実行が記録された日時。
      required:
        - rule_uuid
        - rule_title
        - library_key
        - matched
        - mode
        - is_async
        - severity
        - score_delta
        - action_summary
        - matched_payload
        - created_at
  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.