मुख्य सामग्री पर जाएं
POST
curl

प्राधिकरण

x-api-key
string
header
आवश्यक

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

हेडर

Content-Type
string

JSON बॉडी भेजते समय application/json पर सेट करें।

उदाहरण:

"application/json"

पथ पैरामीटर

session_id
string<uuid>
आवश्यक

उपयोगकर्ता सत्यापन (KYC) सत्र का UUID। यह API कुंजी के समान एप्लिकेशन से संबंधित होना चाहिए — क्रॉस-एप्लिकेशन UUID, हटाए गए सत्र और व्यवसाय सत्यापन (KYB) सत्र ID सभी 404 लौटाते हैं।

उदाहरण:

"8c2f3a14-7e9b-4d23-9e83-3f7d5e8a1c6d"

बॉडी

application/json
new_status
enum<string> | null

प्रविष्टि पर रिकॉर्ड करने के लिए वैकल्पिक स्थिति लेबल। सत्र स्थिति का कोई भी मान स्वीकार करता है, केस-संवेदी ("approved" को 400 के साथ अस्वीकार कर दिया जाता है)। यहाँ स्थिति रिकॉर्ड करने से सत्र की वास्तविक स्थिति नहीं बदलती है — इसके लिए update-status endpoint का उपयोग करें।

उपलब्ध विकल्प:
Not Started,
In Progress,
Approved,
Declined,
In Review,
Expired,
Abandoned,
Kyc Expired,
Resubmitted,
Awaiting User
उदाहरण:

"In Review"

comment
string | null

वैकल्पिक फ़्री-टेक्स्ट नोट (कोई बाध्यकारी लंबाई सीमा नहीं)। जैसा है वैसा ही संग्रहीत; इस endpoint पर @email मेंशन संसाधित नहीं होते हैं।

उदाहरण:

"Flagging for manual document re-check."

प्रतिक्रिया

सत्र के ऑडिट लॉग पर दर्ज की गई प्रविष्टि। सत्र स्वयं अपरिवर्तित रहता है — इसकी status अपना पिछला मान बनाए रखती है और कोई webhook नहीं भेजा जाता है। नई प्रविष्टि GET …/reviews/ के शीर्ष पर भी दिखाई देती है (actor_display: "Unknown" के साथ)।

user
string

एंट्री के लेखक का डिस्प्ले नाम। इस endpoint के माध्यम से बनाई गई प्रविष्टियों के लिए हमेशा "Unknown", क्योंकि यह कोई कर्ता एट्रिब्यूशन रिकॉर्ड नहीं करता है।

उदाहरण:

"Unknown"

new_status
enum<string> | null

प्रविष्टि पर दर्ज स्थिति लेबल, या कोई नहीं भेजे जाने पर null। सत्र की वास्तविक स्थिति प्रभावित नहीं होती है।

उपलब्ध विकल्प:
Not Started,
In Progress,
Approved,
Declined,
In Review,
Expired,
Abandoned,
Kyc Expired,
Resubmitted,
Awaiting User
उदाहरण:

"In Review"

comment
string | null

एंट्री पर रिकॉर्ड किया गया नोट, या यदि कोई नहीं भेजा गया था तो null।

उदाहरण:

"Flagging for manual document re-check."

created_at
string<date-time>

जब प्रविष्टि लिखी गई थी, ISO 8601 UTC।

उदाहरण:

"2026-06-12T00:18:44.466537Z"

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