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

नेटवर्क

फ़्रॉड नेटवर्क टाइमलाइन API

Didit के साथ फ़्रॉड नेटवर्क का इवेंट इतिहास प्राप्त करें, या contract=2 से सदस्य प्रयासों, लेन-देन, साइन-इन, नियम हिट और लिंक्ड केस की पेजिनेटेड टाइमलाइन।

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 पास करें। इसमें सदस्य खातों ने क्या किया और आपकी टीम ने नेटवर्क पर क्या कार्रवाई की, यह जोड़ा जाता है; सबसे नए से शुरू होकर, एक बार में एक पेज। contract केवल 2 स्वीकार करता है; कोई भी अन्य मान 400 लौटाता है।

पैरामीटर	अर्थ
`limit`	प्रति पेज इवेंट की संख्या 1 से 500। डिफ़ॉल्ट 100 है।
`cursor`	पिछले पेज का `next_cursor`। अमान्य या खाली cursor `400` लौटाता है।
`event_type`	रखे जाने वाले इवेंट प्रकार, दोहराकर या कॉमा से अलग करके, अधिकतम 20 मान। डिफ़ॉल्ट सभी प्रकार हैं।

रिस्पॉन्स है {"results": [...], "next_cursor": "..."}। अगला पेज पढ़ने के लिए cursor को next_cursor पर सेट करें, जब तक next_cursor null न हो जाए।

इवेंट प्रकार

`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 कुंजी को नहीं। दो सदस्यों के बीच का लेन-देन उनमें से हर एक के लिए एक बार दिखता है, हर एक के अपने account के साथ। उस लेन-देन पर एक रूल हिट एक बार दिखता है। लॉगिन इवेंट केवल उन साइन-इन के लिए मौजूद होते हैं जिन्हें आपने इवेंट के रूप में पोस्ट किया है: auth.login, security.login_succeeded और उनके विफल रूप।

खाते और रिकॉर्ड

हर सदस्य इवेंट में account होता है, यानी वह सदस्य जिसका वह है, और source_ref, यानी वह सत्र, व्यवसाय सत्र, लेन-देन, निगरानी इवेंट या केस जिससे उसे लिया गया। ownership owned होता है जब रिकॉर्ड उस एप्लिकेशन का हो जिसे आपने कॉल किया, और organization होता है जब वह आपके संगठन के किसी दूसरे एप्लिकेशन का हो। route रिकॉर्ड का प्रकार, UUID और एप्लिकेशन देता है; निगरानी इवेंट या केस के लिए source_ref में route नहीं होता। नेटवर्क के अपने इवेंट में न account होता है न source_ref।

आपकी एप्लिकेशन की API कुंजी, Business Console में Developers -> API keys से। प्राथमिक कुंजी के पास पूर्ण एक्सेस होता है। एक नामित कुंजी को स्कोप किया जा सकता है: प्रति संसाधन none, read या write, कुछ वर्कफ़्लो या स्वीकृत सत्रों तक सीमित, IP पतों की सूची तक सीमित, और समाप्ति तिथि तक सीमित। 401 का अर्थ है कि कुंजी गलत है, निरस्त कर दी गई है या उसकी समय-सीमा समाप्त हो गई है; 403 का अर्थ है कि कोई कुंजी नहीं भेजी गई थी, कुंजी के पास इस संसाधन या कार्रवाई का एक्सेस नहीं है, या अनुरोध उसकी IP सूची से बाहर के पते से आया था; सत्र रूट पर 404 का अर्थ है कि सत्र कुंजी के वर्कफ़्लो या स्थितियों से बाहर है। मीडिया एक्सेस के बिना एक कुंजी को छवि, वीडियो और PDF URL null के रूप में प्राप्त होते हैं, और सत्र write के बिना एक कुंजी को सत्र लिंक और token 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 से 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

अंतिम संशोधन 7 नवंबर 2026

​टाइप्ड टाइमलाइन

​इवेंट प्रकार

​खाते और रिकॉर्ड

​संबंधित

प्राधिकरण

पथ पैरामीटर

क्वेरी पैरामीटर

प्रतिक्रिया

टाइप्ड टाइमलाइन

इवेंट प्रकार

खाते और रिकॉर्ड

संबंधित