不正ネットワークのタイムラインAPI

curl -X GET 'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/networks/n3a5e000-0000-4000-8000-000000000001/timeline/' \
  -H 'x-api-key: YOUR_API_KEY'

{
  "results": [
    {
      "event_type": "network_detected",
      "occurred_at": "2026-10-01T09:12:44Z",
      "label": "Network detected",
      "metadata": {
        "network_id": "N-0042"
      }
    },
    {
      "event_type": "signal_observed",
      "occurred_at": "2026-10-12T16:03:10Z",
      "label": "device observed",
      "metadata": {
        "signal_type": "device",
        "subject_count": 3,
        "is_hub": false
      }
    },
    {
      "event_type": "network_in_review",
      "occurred_at": "2026-10-12T16:30:00Z",
      "label": "Network in_review",
      "metadata": {
        "reason": "Shared device across three new accounts."
      }
    }
  ]
}

GET

organization

{organization_id}

application

{application_id}

networks

{network_uuid}

timeline

curl -X GET 'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/networks/n3a5e000-0000-4000-8000-000000000001/timeline/' \
  -H 'x-api-key: YOUR_API_KEY'

{
  "results": [
    {
      "event_type": "network_detected",
      "occurred_at": "2026-10-01T09:12:44Z",
      "label": "Network detected",
      "metadata": {
        "network_id": "N-0042"
      }
    },
    {
      "event_type": "signal_observed",
      "occurred_at": "2026-10-12T16:03:10Z",
      "label": "device observed",
      "metadata": {
        "signal_type": "device",
        "subject_count": 3,
        "is_hub": false
      }
    },
    {
      "event_type": "network_in_review",
      "occurred_at": "2026-10-12T16:30:00Z",
      "label": "Network in_review",
      "metadata": {
        "reason": "Shared device across three new accounts."
      }
    }
  ]
}

ネットワークのイベント履歴を取得します。 contractを指定しない場合、レスポンスはネットワーク自体の履歴となり、古い順に並び、ページ分割されません。内容は、最初に検知された日時、各シグナルが最後に観測された日時、最新のステータス変更とその理由です。この形式は変更されておらず、limit、cursor、event_typeは無視されます。

型付きタイムライン

代わりに型付きタイムラインを取得するには、contract=2を渡します。メンバーアカウントが行ったことと、チームがそのネットワークに対して行ったことが追加され、新しい順に1ページずつ返されます。 contractは2のみを受け付け、それ以外の値を指定すると400が返されます。

パラメーター	意味
`limit`	1ページあたりのイベント数。1〜500の範囲で指定します。デフォルトは100です。
`cursor`	前のページの`next_cursor`。無効または空のカーソルを指定すると`400`が返されます。
`event_type`	残すイベントタイプ。繰り返し指定またはカンマ区切りで、最大20個まで指定できます。デフォルトはすべてのタイプです。

レスポンスは{"results": [...], "next_cursor": "..."}です。 next_cursorがnullになるまで、cursorにnext_cursorを設定して次のページを取得します。

イベントタイプ

`event_type`	記録される内容	詳細ブロック
`network_detected`	ネットワークが検知された	なし
`signal_observed`	シグナルの最新の観測	なし
`network_active`, `network_in_review`, `network_resolved`, `network_dismissed`	ネットワークの最新のステータス変更。理由は`metadata`に含まれます	なし
`verification_attempt`	メンバー(個人または企業)の認証セッション。番号付き(`attempt_count`件中`attempt`件目)で、却下された場合は却下理由を含みます	`verification_attempt`
`transaction`	メンバーが関与した取引。取引日が記録されます	`transaction`
`login`	イベントAPIを通じてメンバーについて送信したサインインまたは失敗したサインイン	`login`
`rule_hit`	メンバーの取引またはイベントに一致した稼働中のルール	`rule_hit`
`case_linked`	組織内でネットワークに対して開かれたケース	`case_linked`
`note_added`	ネットワークに残されたメモ。本文は含まれません	`note_added`

note_addedイベントはコンソールメンバーにのみ返され、APIキーを使用したリクエストには決して返されません。 2人のメンバー間の取引は、それぞれについて1回ずつ、各自のaccountとともに表示されます。その取引に対するルールヒットは1回だけ表示されます。ログインイベントは、イベントとして送信したサインイン(auth.login、security.login_succeededおよびそれらの失敗形式)についてのみ存在します。

アカウントとレコード

各メンバーイベントには、イベントが属するメンバーを示すaccountと、読み取り元のセッション、企業セッション、取引、モニタリングイベント、またはケースを示すsource_refが含まれます。 ownershipは、レコードが呼び出し先のアプリケーションに属する場合はowned、組織内の別のアプリケーションに属する場合はorganizationになります。 routeはレコードの種類、UUID、アプリケーションを示します。モニタリングイベントまたはケースの場合、source_refにrouteはありません。ネットワーク自体のイベントには、accountもsource_refも含まれません。

関連ページ

承認

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

パスパラメータ

organization_id

string<uuid>

必須

組織のUUIDです。

application_id

string<uuid>

必須

アプリケーションのUUID。

network_uuid

string<uuid>

必須

ネットワークのUUID。

例:

"n3a5e000-0000-4000-8000-000000000001"

クエリパラメータ

contract

enum<string>

2を指定すると型付きタイムラインを返します。デフォルトのタイムラインを使う場合は省略してください。その他の値は400を返します。

利用可能なオプション:

2

limit

integer

デフォルト:100

型付きタイムラインのみ。1ページあたりのイベント数で、1から500です。デフォルトは100です。

必須範囲: 1 <= x <= 500

cursor

string

型付きタイムラインのみ。前のページのnext_cursorです。無効または空のカーソルは400を返します。

event_type

enum<string>[]

型付きタイムラインのみ。保持するイベントタイプです。繰り返し指定またはカンマ区切りで、最大20個まで指定できます。デフォルトはすべてのタイプです。

Maximum array length: 20

利用可能なオプション:

network_detected,

signal_observed,

network_active,

network_in_review,

network_resolved,

network_dismissed,

verification_attempt,

transaction,

login,

rule_hit,

case_linked,

note_added

レスポンス

contractなし：{results}、古い順、ページネーションなし。contract=2あり：{results, next_cursor}、新しい順。

Default timeline (no contract)
Typed timeline page (contract=2)

contractを指定しない場合: ネットワーク自体のイベントを古い順に返し、ページネーションはありません。

results

object[]

Show child attributes

最終更新日 2026年11月1日

​型付きタイムライン

​イベントタイプ

​アカウントとレコード

​関連ページ

承認

パスパラメータ

クエリパラメータ

レスポンス

型付きタイムライン

イベントタイプ

アカウントとレコード

関連ページ