फ़्रॉड नेटवर्क प्राप्त करें API

curl

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/' \
  -H 'x-api-key: YOUR_API_KEY'

from didit import Didit

# Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
# and DIDIT_APPLICATION_ID.
client = Didit()

result = client.networks.retrieve(
    "n3a5e000-0000-4000-8000-000000000001",
)
print(result)

import Didit from "@didit-protocol/sdk-node";

// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
const didit = new Didit();

const result = await didit.networks.retrieve("n3a5e000-0000-4000-8000-000000000001");
console.log(result);

ctx := context.Background()
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
client := didit.NewClient()

result, err := client.Networks.Retrieve(ctx, "n3a5e000-0000-4000-8000-000000000001")
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%+v\n", result)

import me.didit.Didit;

// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
Didit client = new Didit();

var result = client.networks().retrieve("n3a5e000-0000-4000-8000-000000000001");
System.out.println(result);

<?php

require 'vendor/autoload.php';

use Didit\DiditClient;

// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
$didit = new DiditClient();

$result = $didit->networks->retrieve('n3a5e000-0000-4000-8000-000000000001');
print_r($result->toArray());

require "didit"

# Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
# and DIDIT_APPLICATION_ID.
didit = Didit::Client.new

result = didit.networks.retrieve("n3a5e000-0000-4000-8000-000000000001")
puts result.to_h

using System;
using System.Text.Json;
using Didit;

// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
using var client = new DiditClient();

var result = await client.Networks.RetrieveAsync("n3a5e000-0000-4000-8000-000000000001");
Console.WriteLine(JsonSerializer.Serialize(result));

{
  "uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "network_id": "N-0042",
  "name": null,
  "status": "in_review",
  "risk": {
    "score": 82,
    "band": "high",
    "bar": 0.82
  },
  "pattern_types": [
    "exact_same_device",
    "same_email"
  ],
  "signal_types": [
    "device",
    "email"
  ],
  "member_counts": {
    "total": 3,
    "users": 3,
    "businesses": 0,
    "transaction_parties": 0
  },
  "member_status": {
    "approved": 1,
    "declined": 1,
    "in_review": 0,
    "not_completed": 1
  },
  "signal_coverage": {
    "device": {
      "signals": 1,
      "subjects": 3,
      "coverage": 1
    },
    "email": {
      "signals": 1,
      "subjects": 2,
      "coverage": 0.6667
    }
  },
  "first_activity_at": "2026-10-01T09:12:44Z",
  "last_activity_at": "2026-10-12T16:03:10Z",
  "stats": {
    "members": {
      "total": 3,
      "users": 3,
      "businesses": 0,
      "transaction_parties": 0
    },
    "member_status": {
      "approved": 1,
      "declined": 1,
      "in_review": 0,
      "not_completed": 1
    },
    "signals": {
      "total": 2,
      "by_type": {
        "device": {
          "signals": 1,
          "subjects": 3,
          "coverage": 1
        },
        "email": {
          "signals": 1,
          "subjects": 2,
          "coverage": 0.6667
        }
      }
    }
  },
  "fraud_tags": [],
  "risk_signals": {
    "residential_proxy_reuse": {
      "detected": false,
      "signal_count": 0,
      "max_subject_count": 0
    },
    "email_intelligence": {
      "enriched_signal_count": 1,
      "high_risk_count": 0,
      "social_profile_count": 0
    },
    "phone_intelligence": {
      "enriched_signal_count": 0,
      "high_risk_count": 0
    }
  },
  "reviewed_at": "2026-10-12T16:30:00Z",
  "reviewed_by": "reviewer@example.com",
  "review_reason": "Shared device across three new accounts.",
  "notes_count": 0,
  "sharing_mode": "global",
  "cross_org_available": true,
  "cross_org_unavailable_reason": null,
  "tags": [
    {
      "uuid": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "name": "SUSPICIOUS",
      "color": "#6366F1",
      "source": "custom",
      "added_by": null,
      "added_at": "2026-10-13T08:15:00Z"
    }
  ],
  "outcomes": {
    "approved": 1,
    "declined": 1,
    "in_review": 0,
    "total": 3
  },
  "patterns": [
    {
      "type": "background",
      "score": 0.8125,
      "members": 3,
      "reason": null,
      "computed_at": "2026-10-13T08:00:00Z"
    }
  ]
}

GET

organization

{organization_id}

application

{application_id}

networks

{network_uuid}

curl

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/' \
  -H 'x-api-key: YOUR_API_KEY'

from didit import Didit

# Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
# and DIDIT_APPLICATION_ID.
client = Didit()

result = client.networks.retrieve(
    "n3a5e000-0000-4000-8000-000000000001",
)
print(result)

import Didit from "@didit-protocol/sdk-node";

// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
const didit = new Didit();

const result = await didit.networks.retrieve("n3a5e000-0000-4000-8000-000000000001");
console.log(result);

ctx := context.Background()
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
client := didit.NewClient()

result, err := client.Networks.Retrieve(ctx, "n3a5e000-0000-4000-8000-000000000001")
if err != nil {
	log.Fatal(err)
}
fmt.Printf("%+v\n", result)

import me.didit.Didit;

// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
Didit client = new Didit();

var result = client.networks().retrieve("n3a5e000-0000-4000-8000-000000000001");
System.out.println(result);

<?php

require 'vendor/autoload.php';

use Didit\DiditClient;

// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
$didit = new DiditClient();

$result = $didit->networks->retrieve('n3a5e000-0000-4000-8000-000000000001');
print_r($result->toArray());

require "didit"

# Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
# and DIDIT_APPLICATION_ID.
didit = Didit::Client.new

result = didit.networks.retrieve("n3a5e000-0000-4000-8000-000000000001")
puts result.to_h

using System;
using System.Text.Json;
using Didit;

// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
using var client = new DiditClient();

var result = await client.Networks.RetrieveAsync("n3a5e000-0000-4000-8000-000000000001");
Console.WriteLine(JsonSerializer.Serialize(result));

{
  "uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "network_id": "N-0042",
  "name": null,
  "status": "in_review",
  "risk": {
    "score": 82,
    "band": "high",
    "bar": 0.82
  },
  "pattern_types": [
    "exact_same_device",
    "same_email"
  ],
  "signal_types": [
    "device",
    "email"
  ],
  "member_counts": {
    "total": 3,
    "users": 3,
    "businesses": 0,
    "transaction_parties": 0
  },
  "member_status": {
    "approved": 1,
    "declined": 1,
    "in_review": 0,
    "not_completed": 1
  },
  "signal_coverage": {
    "device": {
      "signals": 1,
      "subjects": 3,
      "coverage": 1
    },
    "email": {
      "signals": 1,
      "subjects": 2,
      "coverage": 0.6667
    }
  },
  "first_activity_at": "2026-10-01T09:12:44Z",
  "last_activity_at": "2026-10-12T16:03:10Z",
  "stats": {
    "members": {
      "total": 3,
      "users": 3,
      "businesses": 0,
      "transaction_parties": 0
    },
    "member_status": {
      "approved": 1,
      "declined": 1,
      "in_review": 0,
      "not_completed": 1
    },
    "signals": {
      "total": 2,
      "by_type": {
        "device": {
          "signals": 1,
          "subjects": 3,
          "coverage": 1
        },
        "email": {
          "signals": 1,
          "subjects": 2,
          "coverage": 0.6667
        }
      }
    }
  },
  "fraud_tags": [],
  "risk_signals": {
    "residential_proxy_reuse": {
      "detected": false,
      "signal_count": 0,
      "max_subject_count": 0
    },
    "email_intelligence": {
      "enriched_signal_count": 1,
      "high_risk_count": 0,
      "social_profile_count": 0
    },
    "phone_intelligence": {
      "enriched_signal_count": 0,
      "high_risk_count": 0
    }
  },
  "reviewed_at": "2026-10-12T16:30:00Z",
  "reviewed_by": "reviewer@example.com",
  "review_reason": "Shared device across three new accounts.",
  "notes_count": 0,
  "sharing_mode": "global",
  "cross_org_available": true,
  "cross_org_unavailable_reason": null,
  "tags": [
    {
      "uuid": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "name": "SUSPICIOUS",
      "color": "#6366F1",
      "source": "custom",
      "added_by": null,
      "added_at": "2026-10-13T08:15:00Z"
    }
  ],
  "outcomes": {
    "approved": 1,
    "declined": 1,
    "in_review": 0,
    "total": 3
  },
  "patterns": [
    {
      "type": "background",
      "score": 0.8125,
      "members": 3,
      "reason": null,
      "computed_at": "2026-10-13T08:00:00Z"
    }
  ]
}

एक नेटवर्क को उसके पूरे विवरण के साथ प्राप्त करें, जो नेटवर्क के अवलोकन पैनल को प्रदर्शित करने के लिए ज़रूरी है: उसका जोखिम-विभाजन, पहचाने गए धोखाधड़ी टैग, और जोखिम-संकेत सारांश। ये सूची में दिए गए साझा फ़ील्ड के अतिरिक्त हैं। विवरण में आपके एप्लिकेशन के नेटवर्क पर लगाए गए टैग भी शामिल हैं, साथ ही उसके सदस्यों के सत्यापन की स्थिति क्या है, और उनकी सेल्फ़ी पृष्ठभूमि कितनी एक-जैसी हैं।

tags नेटवर्क पर आपके एप्लिकेशन के टैग सबसे पुराने से नए क्रम में सूचीबद्ध करता है। हर एप्लिकेशन केवल अपने टैग देखता और बदलता है। added_by उस कंसोल सदस्य का ईमेल है जिसने टैग जोड़ा, या null जब टैग किसी API कुंजी ने जोड़ा हो। इन्हें बदलने के लिए नेटवर्क टैग जोड़ें और नेटवर्क टैग हटाएँ का उपयोग करें। fraud_tags अपरिवर्तित है: यह वे टैग सूचीबद्ध करता है जो नेटवर्क के सदस्य रखते हैं।

सदस्य परिणाम

outcomes उन व्यक्तियों और व्यवसायों की गिनती करता है जो नेटवर्क में हैं और जिन्हें आप देख सकते हैं, हर एक को एक बार गिनते हुए।

कुंजी	क्या गिनती है
`approved`	वे सदस्य जिनका सबसे हाल का निर्णीत सत्यापन स्वीकृत हुआ
`declined`	वे सदस्य जिनका सबसे हाल का निर्णीत सत्यापन अस्वीकृत हुआ
`in_review`	वे सदस्य जिनका सबसे हाल का निर्णीत सत्यापन समीक्षाधीन है
`total`	वे सदस्य जिनके पास कम से कम एक सत्यापन है, चाहे निर्णीत हो या नहीं

जो सदस्य अस्वीकृत हुआ और फिर पुनः प्रयास पर स्वीकृत हो गया, वह approved में गिना जाता है। जिस सदस्य के सभी सत्यापन अनिर्णीत हैं (शुरू नहीं हुए, प्रगति में हैं, समय-सीमा समाप्त या छोड़ा गया), वह केवल total में गिना जाता है। लेन-देन के पक्षकारों का कोई सत्यापन नहीं होता, इसलिए उन्हें नहीं गिना जाता।

सेल्फ़ी पृष्ठभूमि पैटर्न

patterns में आज एक ही आइटम है, जिसका type background पर सेट है। इसका score, 0 से 1 तक, हर सदस्य की सेल्फ़ी पृष्ठभूमियों के प्रत्येक जोड़े की औसत समानता है, जिसमें व्यक्ति को मास्क करके हटा दिया गया है। लगभग 1 का स्कोर संकेत देता है कि सेल्फ़ी एक ही जगह पर ली गई होंगी। एक-जैसे रंग की सादी दीवारें भी उच्च स्कोर दे सकती हैं, इसलिए स्कोर को समीक्षा के लिए साक्ष्य मानें, प्रमाण नहीं। स्कोर हर व्यक्ति की सबसे नई सेल्फ़ी पढ़ता है, अधिकतम 50 सबसे नई सेल्फ़ियों को, और आयु आश्वासन सत्रों को शामिल नहीं करता। यह पूरे नेटवर्क को कवर करता है, केवल आपके एप्लिकेशनों के सदस्यों को नहीं।

`reason`	`score`	`members`	क्या करें
`null`	0 से 1	तुलना की गई सेल्फ़ी	स्कोर का उपयोग करें। `computed_at` बताता है कि इसकी गणना कब हुई।
`computing`	`null`	`null`	वर्तमान सदस्यों के लिए स्कोर की गणना हो रही है। बाद में नेटवर्क को फिर से पढ़ें।
`not_enough_selfies`	`null`	`0` या `1`	दो से कम सदस्यों के पास उपयोग में आने लायक सेल्फ़ी हैं।

जो सेल्फ़ी पढ़ी नहीं जा सकती, या जिसमें पृष्ठभूमि बहुत कम दिखती है, उसकी तुलना नहीं होती, इसलिए members नेटवर्क के लोगों की संख्या से कम हो सकता है। स्कोर हमेशा वर्तमान सदस्य सेल्फ़ी का वर्णन करता है। जब वे बदलती हैं, उदाहरण के लिए जब कोई सदस्य जुड़ता है या नेटवर्क छोड़ता है, तो विवरण नया स्कोर तैयार होने तक computing दिखाता है, या जब दो से कम सेल्फ़ी बचें तो not_enough_selfies।

संगठनों के बीच उपलब्धता

विवरण में वही sharing_mode, cross_org_available और cross_org_unavailable_reason होते हैं जो नेटवर्क की सूची में हैं। संगठनों के बीच के संकेतों के लिए Enterprise प्लान और global शेयरिंग मोड, दोनों ज़रूरी हैं।

आपकी एप्लिकेशन की 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"

प्रतिक्रिया

नेटवर्क विवरण।

नेटवर्क विवरण, साथ ही संगठन का शेयरिंग मोड, क्या इस पर क्रॉस-संगठन सिग्नल लागू होते हैं, नेटवर्क पर आपके एप्लिकेशन के टैग, सदस्य परिणाम और पैटर्न स्कोर।

uuid

string<uuid>

network_id

string

मानव-पठनीय प्रति-संगठन अनुक्रमिक id, उदाहरण के लिए N-0001।

name

string | null

status

enum<string>

नेटवर्क लाइफ़साइकल स्थिति। किसी नेटवर्क के अंदर प्रति-आवेदक outcome_status (approved/in_review/declined/not_completed) से अलग।

उपलब्ध विकल्प:

active,

in_review,

resolved,

dismissed

risk

object

Show child attributes

pattern_types

enum<string>[]

इस नेटवर्क में पाए गए क्लस्टरिंग पैटर्न।

उपलब्ध विकल्प:

exact_same_device,

similar_device,

same_ip_address,

same_address,

similar_selfie_backgrounds,

similar_poa_documents,

same_document_number,

same_phone_number,

same_email

signal_types

enum<string>[]

इस नेटवर्क में मौजूद विशिष्ट सिग्नल प्रकार।

उपलब्ध विकल्प:

ip_address,

device,

face,

document_number,

phone,

email,

address

member_counts

object

श्रेणी के अनुसार सदस्यों की संख्या (उदा. कुल, प्रति outcome_status)।

member_status

object

outcome_status के अनुसार सदस्यों का विवरण।

signal_coverage

object

इस नेटवर्क के सदस्यों का प्रति signal_type कवरेज।

first_activity_at

string<date-time> | null

last_activity_at

string<date-time> | null

stats

object

नेटवर्क के लिए समग्र आँकड़े (उदा. कुल सदस्य संख्या)।

fraud_tags

object[]

नेटवर्क पर सामने आए फ्रॉड-पैटर्न टैग।

risk_signals

object

जोखिम सिग्नल सारांश: residential_proxy_reuse, email_intelligence, phone_intelligence।

reviewed_at

string<date-time> | null

reviewed_by

string | null

review_reason

string | null

notes_count

integer

read-only

इस जांच में निजी विश्लेषक नोटों की संख्या।

आवश्यक सीमा: x >= 0

संगठन का क्रॉस-संगठन शेयरिंग मोड। केवल global ही विभिन्न संगठनों के नेटवर्क की तुलना करता है; private और off उन्हें संगठन के अपने इतिहास तक ही सीमित रखते हैं।

उपलब्ध विकल्प:

off,

private,

global

उदाहरण:

"global"

cross_org_available

boolean

क्या क्रॉस-संगठन संकेत इस संगठन पर लागू होते हैं। उन्हें Enterprise प्लान और global शेयरिंग मोड दोनों की आवश्यकता होती है।

उदाहरण:

true

cross_org_unavailable_reason

enum<string> | null

क्रॉस-ऑर्गेनाइज़ेशन सिग्नल क्यों लागू नहीं होते, इस क्रम में जाँचे जाते हैं। plan: संगठन के प्लान में क्रॉस-ऑर्गेनाइज़ेशन फ़्रॉड नेटवर्क शामिल नहीं है (इसके लिए Enterprise प्लान की आवश्यकता है), भले ही शेयरिंग मोड कुछ भी हो। sharing_mode: प्लान में यह शामिल है, लेकिन शेयरिंग मोड private या off है। cross_org_available के true होने पर Null।

उपलब्ध विकल्प:

plan,

sharing_mode

उदाहरण:

null

​टैग

​सदस्य परिणाम

​सेल्फ़ी पृष्ठभूमि पैटर्न

​संगठनों के बीच उपलब्धता

​संबंधित

प्राधिकरण

पथ पैरामीटर

प्रतिक्रिया

टैग

सदस्य परिणाम

सेल्फ़ी पृष्ठभूमि पैटर्न

संगठनों के बीच उपलब्धता

संबंधित