Betrugsnetzwerk-Timeline 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."
      }
    }
  ]
}

Rufen Sie den Ereignisverlauf eines Netzwerks ab. Ohne contract ist die Antwort der eigene Verlauf des Netzwerks, der älteste Eintrag zuerst und nicht paginiert: wann es erstmals erkannt wurde, wann jedes Signal zuletzt beobachtet wurde und seine letzte Statusänderung mit dem Grund. Dieses Format ist unverändert, und limit, cursor und event_type werden ignoriert.

Typisierte Timeline

Übergeben Sie contract=2, um stattdessen die typisierte Timeline abzurufen. Sie enthält zusätzlich, was die Mitgliedskonten getan haben und was Ihr Team in Bezug auf das Netzwerk unternommen hat, der neueste Eintrag zuerst, seitenweise. contract akzeptiert nur 2; jeder andere Wert gibt 400 zurück.

Parameter	Bedeutung
`limit`	Ereignisse pro Seite, 1 bis 500. Standardwert ist 100.
`cursor`	Der `next_cursor` der vorherigen Seite. Ein ungültiger oder leerer Cursor gibt `400` zurück.
`event_type`	Die beizubehaltenden Ereignistypen, wiederholt oder kommagetrennt, höchstens 20 Werte. Standardmäßig werden alle Typen zurückgegeben.

Die Antwort lautet {"results": [...], "next_cursor": "..."}. Rufen Sie die nächste Seite ab, indem Sie cursor auf next_cursor setzen, bis next_cursor den Wert null hat.

Ereignistypen

`event_type`	Was sie erfasst	Detailblock
`network_detected`	Das Netzwerk wurde erkannt	Keiner
`signal_observed`	Die letzte Beobachtung eines Signals	Keiner
`network_active`, `network_in_review`, `network_resolved`, `network_dismissed`	Die letzte Statusänderung des Netzwerks mit dem Grund in `metadata`	Keiner
`verification_attempt`	Eine Verifizierungssitzung eines Mitglieds (einer Person oder eines Unternehmens), nummeriert (`attempt` von `attempt_count`), mit den Ablehnungsgründen, wenn sie abgelehnt wurde	`verification_attempt`
`transaction`	Eine Transaktion, an der ein Mitglied beteiligt war, datiert nach ihrem Transaktionsdatum	`transaction`
`login`	Eine Anmeldung oder fehlgeschlagene Anmeldung, die Sie für ein Mitglied über die Ereignis-API übermittelt haben	`login`
`rule_hit`	Eine aktive Regel, die auf eine Transaktion oder ein Ereignis eines Mitglieds zutraf	`rule_hit`
`case_linked`	Ein Fall, der für das Netzwerk in Ihrer Organisation eröffnet wurde	`case_linked`
`note_added`	Eine Notiz zum Netzwerk, ohne deren Text	`note_added`

note_added-Ereignisse werden nur Mitgliedern der Konsole zurückgegeben, niemals einem API-Schlüssel. Eine Transaktion zwischen zwei Mitgliedern erscheint für jedes von ihnen einmal, jeweils mit eigenem account. Ein Regel-Treffer auf diese Transaktion erscheint einmal. Login-Ereignisse gibt es nur für die Anmeldungen, die Sie als Ereignisse übermitteln: auth.login, security.login_succeeded und deren fehlgeschlagene Formen.

Konten und Datensätze

Jedes Mitgliedsereignis enthält account, das zugehörige Mitglied, sowie source_ref, die Sitzung, Unternehmenssitzung, Transaktion, das Monitoring-Ereignis oder den Fall, aus dem das Ereignis gelesen wurde. ownership ist owned, wenn der Datensatz zur aufgerufenen Anwendung gehört, und organization, wenn er zu einer anderen Anwendung Ihrer Organisation gehört. route gibt die Art des Datensatzes, seine UUID und seine Anwendung an; source_ref enthält kein route für ein Monitoring-Ereignis oder einen Fall. Die eigenen Ereignisse des Netzwerks enthalten weder account noch source_ref.

Verwandte Themen

Autorisierungen

x-api-key

string

header

erforderlich

Der API-Schlüssel Ihrer Anwendung, aus Entwickler -> API-Schlüssel in der Business Console. Der Primärschlüssel hat Vollzugriff. Ein benannter Schlüssel kann im Geltungsbereich eingeschränkt werden: keine, Lese- oder Schreibberechtigung pro Ressource, beschränkt auf bestimmte Workflows oder genehmigte Sitzungen, auf eine Liste von IP-Adressen und auf ein Ablaufdatum. 401 bedeutet, dass der Schlüssel falsch, widerrufen oder abgelaufen ist; 403 bedeutet, dass kein Schlüssel gesendet wurde, der Schlüssel keinen Zugriff auf diese Ressource oder Aktion hat oder die Anfrage von einer Adresse außerhalb seiner IP-Liste stammte; 404 bei einer Sitzungsroute bedeutet, dass die Sitzung außerhalb der Workflows oder Status des Schlüssels liegt. Ein Schlüssel ohne Medienzugriff erhält Bild-, Video- und PDF-URLs als null, und ein Schlüssel ohne Schreibberechtigung für Sitzungen erhält Sitzungslinks und Token als null. Siehe https://docs.didit.me/console/api-keys.

Pfadparameter

organization_id

string<uuid>

erforderlich

UUID der Organisation.

application_id

string<uuid>

erforderlich

Anwendungs-UUID.

network_uuid

string<uuid>

erforderlich

Netzwerk-UUID.

Beispiel:

"n3a5e000-0000-4000-8000-000000000001"

Abfrageparameter

contract

enum<string>

2 gibt die typisierte Timeline zurück. Lassen Sie den Parameter für die Standard-Timeline weg. Jeder andere Wert gibt 400 zurück.

Verfügbare Optionen:

2

limit

integer

Standard:100

Nur für typisierte Timelines. Ereignisse pro Seite, 1 bis 500. Standardwert ist 100.

Erforderlicher Bereich: 1 <= x <= 500

cursor

string

Nur typisierte Timeline. Der next_cursor der vorherigen Seite. Ein ungültiger oder leerer Cursor gibt 400 zurück.

event_type

enum<string>[]

Nur für typisierte Timelines. Beizubehaltende Ereignistypen, wiederholt oder kommagetrennt, maximal 20 Werte. Standardmäßig alle Typen.

Maximum array length: 20

Verfügbare Optionen:

network_detected,

signal_observed,

network_active,

network_in_review,

network_resolved,

network_dismissed,

verification_attempt,

transaction,

login,

rule_hit,

case_linked,

note_added

Antwort

Ohne contract: {results}, älteste zuerst, nicht paginiert. Mit contract=2: {results, next_cursor}, neueste zuerst.

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

Ohne contract: Die netzwerkeigenen Ereignisse, älteste zuerst, nicht paginiert.

results

object[]

Show child attributes

Zuletzt geändert am 7. November 2026

​Typisierte Timeline

​Ereignistypen

​Konten und Datensätze

​Verwandte Themen

Autorisierungen

Pfadparameter

Abfrageparameter

Antwort

Typisierte Timeline

Ereignistypen

Konten und Datensätze

Verwandte Themen