メインコンテンツへスキップ
GET
curl
イベントは保持クラスごとに保存されるため、クラスの保持期間を過ぎたイベントはここに表示されなくなります。フィルターのリファレンスについてはイベントの取り込みを、rules_matched_countが変化する条件についてはイベントに対するルールを参照してください。

承認

x-api-key
string
header
必須

お客様のアプリケーションのAPIキーです。Business ConsoleのDevelopers -> API keysで取得できます。プライマリキーはフルアクセス権を持ちます。名前付きキーにはスコープを設定できます。リソースごとのアクセス権(なし、読み取り、書き込み)、一部のワークフローまたは承認済みセッションへの限定、IPアドレスのリストへの限定、有効期限の設定です。401は、キーが誤っている、失効している、または期限切れであることを意味します。403は、キーが送信されていない、キーにこのリソースやアクションへのアクセス権がない、またはIPリスト外のアドレスからリクエストが送信されたことを意味します。セッションのルートでの404は、セッションがキーのワークフローまたはステータスの対象外であることを意味します。メディアへのアクセス権がないキーでは、画像、動画、PDFのURLがnullで返されます。セッションの書き込み権限がないキーでは、セッションのリンクとトークンがnullで返されます。詳細は次を参照してください: https://docs.didit.me/console/api-keys

クエリパラメータ

limit
integer
デフォルト:50

1ページあたりの最大イベント数です。デフォルトは50です。1000000を超える値は400を返し、数値以外、0、または負の値は50にフォールバックします。

必須範囲: 1 <= x <= 1000000
offset
integer
デフォルト:0

スキップするイベントの数。デフォルトは0です。レスポンスのnextのURLをたどることを推奨します。

必須範囲: 0 <= x <= 1000000
event_category
enum<string>[]

これらのカテゴリのイベントのみ。複数の値を指定するにはパラメーターを繰り返します(?event_category=payment&event_category=dispute)。いずれかに一致するイベントが返されます。

利用可能なオプション:
auth,
session,
gameplay,
bonus,
affiliate,
payment,
dispute,
security,
responsible_gambling,
custom
action_type
string[]

これらのアクションタイプ(完全一致、大文字と小文字を区別)のイベントのみ。複数の値を指定するには繰り返します。

status
enum<string>[]

これらのステータスのイベントのみ。複数の値を指定するには繰り返します。

利用可能なオプション:
ACCEPTED,
APPROVED,
IN_REVIEW,
DECLINED
retention_class
enum<string>[]

これらの保持クラスのイベントのみ。複数の値を指定するには繰り返します。

利用可能なオプション:
low_value,
standard,
risk_relevant,
monetary_or_compliance
subject_vendor_data
string

対象者のvendor_dataとの完全一致です。同じIDが個人と企業の両方を指す場合があります。いずれかを選ぶにはsubject_entity_typeを追加するか、GET /v3/events/subjects/{vendor_data}/を使用してください。

subject_entity_type
enum<string>

companyは企業サブジェクトのイベントのみを返します。それ以外の空でない値(例:individual)は個人のイベントのみを返します。省略すると両方を返します。

利用可能なオプション:
individual,
company
business_vendor_data
string

イベントとともに送信されたbusiness.vendor_dataとの完全一致です。

session_id
string

session.session_idとの完全一致です。

device_fingerprint
string

device_context.fingerprintとの完全一致です。

ip_address
string

イベントのIPアドレスとの完全一致です。

game_id
string

昇格済みのgame_idとの完全一致です。

round_id
string

昇格済みのround_idとの完全一致です。

affiliate_code
string

昇格済みのaffiliate_codeとの完全一致です。

payment_reference_id
string

支払い参照(transaction_context.payment_reference_idまたはpayload.payment_reference_idから取得)との完全一致です。

counterparty_vendor_data
string

昇格済みのcounterparty_vendor_dataとの完全一致です。

matched_only
boolean
デフォルト:false

true(1またはyesも可、大文字と小文字は区別しません)を指定すると、少なくとも1つのルールに一致したイベント(rules_matched_countが0より大きいもの)のみを返します。それ以外の値は無視されます。

occurred_from
string<date-time>

occurred_atがこの時点以降(この時点を含む)のイベントのみ。ISO 8601形式の値を送信してください。2026-10-01T00:00:00Z、+をパーセントエンコードした明示的なオフセット(2026-10-01T02:00:00%2B02:00。エンコードされていない+はスペースとしてデコードされ、値を解析できなくなります)、または日付のみ(2026-10-01)で、日付のみの場合はその日の00:00:00 UTCを意味します。オフセットのない値はUTCとして解釈されます。その他の形式の値は受け付けません。

occurred_to
string<date-time>

occurred_atがこの時点以前(この時点を含む)のイベントのみ。日付のみの場合はその日の開始時刻を意味するため、occurred_to=2026-10-15では10月15日の残りの時間が除外されます。含めるには2026-10-15T23:59:59Zを送信してください。ISO 8601形式の値を送信してください。2026-10-01T00:00:00Z、+をパーセントエンコードした明示的なオフセット(2026-10-01T02:00:00%2B02:00。エンコードされていない+はスペースとしてデコードされ、値を解析できなくなります)、または日付のみ(2026-10-01)で、日付のみの場合はその日の00:00:00 UTCを意味します。オフセットのない値はUTCとして解釈されます。その他の形式の値は受け付けません。

event_id、action_type、subject_vendor_data、またはcounterparty_vendor_dataに対する大文字・小文字を区別しない部分一致。

レスポンス

イベントサマリーの1ページ分です。

モニタリングイベントの1ページ分です。occurred_atが新しい順に並びます。

count
integer
必須

一致するイベントの数。100までは正確な値で、100を超える場合は100が上限となります。この値からページ数を計算せず、nullになるまでnextをたどってください。

next
string<uri> | null
必須

次のページのURL。最後のページではnullです。

previous
string<uri> | null
必須

前のページのURL。最初のページではnullです。

results
object[]
必須
最終更新日 2026年11月1日