GET /apiv2/screening/history

आपका स्क्रीनिंग इतिहास, सबसे नया पहले, कर्सर पेजिनेशन के साथ।

यह संस्करण 2 अनुबंध है। यह GET /apiv2/aml/history की जगह लेता है, जो काम करना जारी रखता है।

एंडपॉइंट URL

GET https://netts.io/apiv2/screening/history

अनुरोध हेडर

Header	Required	Description
X-API-KEY	हाँ	Netts डैशबोर्ड से आपकी API कुंजी

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

सभी फ़िल्टर वैकल्पिक हैं। इनमें से किसी के बिना भी आपको अपना पूरा इतिहास मिल जाता है।

Parameter	Type	Default	Description
address	string	—	सटीक पता, 10–128 वर्ण
network	string	—	नेटवर्क टिकर
provider	string	—	elliptic या bitok
status	string	—	pending, processing, completed, skipped, failed
from	string	—	केवल इस समय या इसके बाद बनाई गई जाँचें, RFC 3339
to	string	—	केवल इस समय या इससे पहले बनाई गई जाँचें, RFC 3339
cursor	string	—	कहाँ से जारी रखना है। इसे next_cursor से लें
limit	integer	50	प्रति पृष्ठ आइटम, 1 से 200

संस्करण 1 में address और network दोनों आवश्यक थे, इसलिए यह पूछने का कोई तरीका नहीं था कि "मैंने हाल ही में क्या जाँचा है"।

skipped स्थिति वाली जाँचें शामिल हैं। संस्करण 1 उन्हें छुपाता है। एक छोड़ी गई (skipped) जाँच एक वास्तविक ऑर्डर है — पते पर कोई ब्लॉकचेन गतिविधि नहीं थी, इसलिए इसे कभी भी प्रदाता को नहीं भेजा गया और कभी शुल्क नहीं लिया गया — और यह इतिहास से संबंधित है।

उदाहरण

cURL

curl "https://netts.io/apiv2/screening/history?limit=50" \
  -H "X-API-KEY: your_api_key"

Python — पूरा इतिहास देखें

import requests

headers = {"X-API-KEY": "your_api_key"}
params = {"limit": 200, "provider": "elliptic"}

while True:
    page = requests.get("https://netts.io/apiv2/screening/history",
                        headers=headers, params=params).json()
    for item in page["items"]:
        print(item["order"]["client_order_id"],
              item["order"]["status"],
              item["risk"]["level"],
              item["sanctions"]["verdict"])

    if not page["next_cursor"]:
        break
    params = {"limit": 200, "provider": "elliptic", "cursor": page["next_cursor"]}

पेजिंग करते समय फ़िल्टर समान रखें। एक ही कर्सर का उपयोग करते हुए किसी फ़िल्टर को बदलना एक त्रुटि है, किसी भिन्न सेट पर बिना सूचना के बदलाव नहीं।

प्रतिक्रिया

{
  "schema_version": 2,
  "items": [
    {
      "order": {
        "client_order_id": "A6F3221BAAE093A",
        "status": "completed",
        "api_version": "v2",
        "cache_hit": false,
        "created_at": "2026-09-13T08:24:19.838584Z",
        "started_at": "2026-09-13T08:24:20.998619Z",
        "completed_at": "2026-09-13T08:24:25.179967Z"
      },
      "request": {
        "address": "YOUR_ADDRESS_HERE",
        "network": "trx",
        "provider": "elliptic"
      },
      "check": {
        "provider": "elliptic",
        "provider_check_id": "1cc2fd64-1483-4ce3-946f-23a614f41a12",
        "checked_at": "2026-09-13T08:24:22.372000Z",
        "status": "completed",
        "provider_status": "complete"
      },
      "risk": {
        "score": "0.12428176721891304",
        "scale": { "min": 0, "max": 10 },
        "level": "low",
        "level_source": "computed",
        "provider_level": null,
        "policy": "netts-risk-v1",
        "by_direction": { "source": "0.12428176721891304", "destination": null }
      },
      "sanctions": { "verdict": "linked" }
    }
  ],
  "next_cursor": "eyJmIjp7InN0YXR1cyI6ImNvbXBsZXRlZCJ9LCJpIjoxMzQyNywidCI6...",
  "limit": 1
}

Field	Type	Description
items	array	पृष्ठ, सबसे नया पहले
next_cursor	string | null	अगला पृष्ठ प्राप्त करने के लिए इसे वापस पास करें। null का अर्थ है कि आप अंत तक पहुँच गए हैं
limit	integer	लागू की गई सीमा

किसी आइटम का संक्षिप्त रूप

order, request, check और risk ब्लॉक GET /apiv2/screening/{client_order_id} की पूर्ण प्रतिक्रिया में मौजूद ब्लॉक के समान हैं, फ़ील्ड दर फ़ील्ड, ताकि एक ही पार्सर दोनों को संभाल सके।

जो छोड़ दिया गया है: provider_data, exposure[], rules[], entities[], wallet, billing, precheck, और पूर्ण sanctions ब्लॉक। एक एकल Elliptic परिणाम लगभग 150 KB का होता है, और पचास का एक पृष्ठ सात मेगाबाइट का होगा। जब आपको विवरण की आवश्यकता हो तो एकल जाँच प्राप्त करें।

sanctions.verdict

प्रतिबंध विश्लेषण एक शब्द में संकुचित।

Value	Meaning
listed	पता स्वयं प्रतिबंध सूची में है
linked	एक प्रतिबंध लिंक मिला, लेकिन पता स्वयं सूचीबद्ध नहीं है
none	विश्लेषण चला और कुछ नहीं मिला
null	विश्लेषण करने के लिए अभी तक कोई परिणाम नहीं है

listed और linked के बीच का अंतर ही इस फ़ील्ड का उद्देश्य है — देखें AML परिणाम में प्रतिबंध।

पेजिनेशन

संस्करण 1 संख्या द्वारा पृष्ठ बनाता है: ?page=2, 100 प्रति पृष्ठ। क्रम निर्माण समय के अनुसार है, सबसे नया पहले, इसलिए जब आप पृष्ठ 1 से पृष्ठ 2 पर जाते हैं तो नई जाँचें आती हैं और सब कुछ नीचे धकेल देती हैं। आपके द्वारा पहले देखे जा चुके रिकॉर्ड फिर से दिखाई देते हैं, और जो रिकॉर्ड आपने नहीं देखे हैं वे छूट जाते हैं। एक व्यस्त खाते के साथ यह कोई असामान्य मामला नहीं है।

एक कर्सर सेट में उसकी क्रम संख्या के बजाय एक स्थान की ओर इशारा करता है, इसलिए पेजिनेशन के दौरान आने वाली नई जाँचें इसे बाधित नहीं करती हैं।

• क्रम created_at DESC, id DESC है। दोनों फ़ील्ड कर्सर में हैं, क्योंकि created_at अद्वितीय नहीं है — एक ही माइक्रोसेकंड में बनाई गई दो जाँचें अन्यथा लूप में आ जाएँगी या छूट जाएँगी;
• कर्सर अस्पष्ट (opaque) है। इसकी सामग्री कार्यान्वयन का एक विवरण है; इसे ठीक वैसे ही वापस पास करें जैसे आपने इसे प्राप्त किया था;
• फ़िल्टर कर्सर का हिस्सा हैं। कर्सर का पुन: उपयोग करते हुए किसी फ़िल्टर को बदलने पर 400 मिलता है, किसी भिन्न सेट पर बिना सूचना के बदलाव नहीं — अन्यथा आप मान लेंगे कि आपने एक ऐसा सेट पढ़ लिया है जिसे आपने कभी नहीं पढ़ा था;
• next_cursor: null का अर्थ अंत है। कोई कुल गणना नहीं है: प्रत्येक पृष्ठ पर पूरे सेट की गणना करना उससे अधिक महंगा पड़ता है जितना वह बताता है।

त्रुटि प्रतिक्रियाएं

RFC 9457, application/problem+json। पूरी कोड सूची POST पृष्ठ पर है।

Code	HTTP	When
4001	400	limit 1…200 से बाहर है, एक अज्ञात network, provider या status, एक from/to जो RFC 3339 नहीं है, एक विकृत कर्सर, या विभिन्न फ़िल्टरों के लिए जारी किया गया कर्सर
4010 / 4011	401	कोई API कुंजी नहीं है, या ऐसी कुंजी या IP जिसे स्वीकार नहीं किया गया है

{
  "type": "https://doc.netts.io/api/v2/errors/validation-failed",
  "title": "Request validation failed",
  "status": 400,
  "detail": "Cursor was issued for a different set of filters",
  "instance": "/apiv2/screening/history",
  "code": 4001
}

दर सीमाएं

हर दूसरे AML पथ के साथ साझा किया गया: 5 अनुरोध प्रति सेकंड, 150 प्रति मिनट। limit=200 के साथ दस हजार जाँचों का पूरा इतिहास पचास अनुरोध है।