> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # KYB रजिस्ट्री सेलेक्ट API: कंपनी प्रोफ़ाइल प्राप्त करें > Didit के POST /v3/kyb/select/ से, कंपनी रजिस्ट्री खोज के kyb_response_id का उपयोग करके पूरी बिलेबल KYB कंपनी प्रोफ़ाइल प्राप्त करें। `POST /v3/kyb/search/` से उम्मीदवार कंपनियाँ मिलने के बाद इस endpoint का उपयोग करें। Select **Lite** स्तर है: यह कंपनी की प्रोफ़ाइल और उसके अधिकारियों को प्राप्त करता है, और इसका शुल्क देश की Lite कीमत पर लगता है ([प्रति देश कीमतें](https://docs.didit.me/hi/getting-started/kyb-registry-pricing.md))। यह अनुरोध को Business Console में Manual Check के रूप में सहेजता है और एक `request_id` लौटाता है, जिससे आप सहेजा गया व्यवसाय सत्यापन परिणाम प्राप्त कर सकते हैं। शेयरधारकों या अंतिम वास्तविक स्वामियों के लिए [`POST /v3/kyb/shareholders/`](https://docs.didit.me/hi/standalone-apis/kyb-registry-shareholders) या [`POST /v3/kyb/ubo/`](https://docs.didit.me/hi/standalone-apis/kyb-registry-ubo) का उपयोग करें। Didit जवाब देने से पहले स्रोत रजिस्ट्री के पूरा होने तक प्रतीक्षा करता है, इसलिए अधिकतर जवाबों में `fetch_status` का मान `resolved` होता है। यदि कोई धीमी रजिस्ट्री उस प्रतीक्षा अवधि के बाद भी प्रोफ़ाइल को लंबित रखती है, तो जवाब में `fetch_status: pending` और `data_resolved: false` आता है, और प्रदाता का काम पूरा होते ही Didit सहेजी गई जाँच अपने आप पूरी कर देता है। खोज को दोबारा न दोहराएँ; इसके बजाय सहेजा गया सत्यापन परिणाम फिर से पढ़ें, क्योंकि नई खोज से नए `kyb_response_id` मान जारी होते हैं। ## OpenAPI ````yaml hi/openapi-25.json POST /v3/kyb/select/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: पहचान सत्यापन API। x-api-key हेडर के साथ प्रमाणीकृत करें। servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/kyb/select/: post: tags: - Standalone APIs summary: KYB रजिस्ट्री कंपनी चयन — Lite स्तर (स्टैंडअलोन) description: >- `POST /v3/kyb/search/` द्वारा लौटाए गए एक उम्मीदवार की **Lite** रजिस्ट्री प्रोफ़ाइल प्राप्त करें — कंपनी विवरण, पंजीकृत पता, पहचानकर्ता, स्थिति, गतिविधि और अधिकारी, साथ ही रॉ रजिस्ट्री payload। शेयरधारक और वास्तविक स्वामी `POST /v3/kyb/shareholders/` और `POST /v3/kyb/ubo/` के माध्यम से उपलब्ध कराए जाते हैं। **सर्च के साथ युग्मन।** उम्मीदवार की `kyb_response_id` ठीक उसी प्रकार पास करें जैसा उसी एप्लिकेशन के सर्च द्वारा लौटाया गया था। हैंडल अल्पकालिक होता है और उस सर्च तक ही सीमित होता है — तुरंत चयन करें, और इसे संग्रहीत करने के बजाय नए हैंडल के लिए फिर से सर्च करें। **बिलिंग।** प्रत्येक चयन का बिल देश की Lite कीमत पर लिया जाता है (कोई भी सर्च शुल्क अलग है); [KYB रजिस्ट्री मूल्य निर्धारण](/hi/getting-started/kyb-registry-pricing) देखें। किसी भी रजिस्ट्री कॉल से पहले बैलेंस की जांच की जाती है (कमी होने पर `403`) और शुल्क बनाए गए व्यावसायिक सत्र के विरुद्ध दर्ज किया जाता है। **स्थायित्व अनिवार्य है।** प्रत्येक चयन एक व्यावसायिक सत्र बनाता है (इसकी id `request_id` है) ताकि बिलिंग और पुनर्प्राप्ति को ट्रैक किया जा सके; यह कंसोल में दिखाई देता है। समरूपता के लिए `save_api_request` स्वीकार किया जाता है लेकिन यह `true` (डिफ़ॉल्ट) होना चाहिए — `false` भेजने पर `400` लौटता है। operationId: post_v3_kyb_select parameters: [] requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/KYBRegistryCandidateRequest' example: kyb_response_id: 69aeeb95febb0f1704042259 vendor_data: company-1234 responses: '200': description: >- कंपनी प्राप्त की गई और बिल की गई। `kyb_registry` में पूर्ण प्रोफ़ाइल शामिल है; `data_resolved` की जाँच करें — जब `false` हो, तो रजिस्ट्री अभी भी प्रोसेस कर रही थी और रिज़ॉल्व होने पर संग्रहीत रिकॉर्ड अपने आप पूरा हो जाता है। content: application/json: schema: type: object properties: request_id: type: string format: uuid description: >- इस पुनर्प्राप्ति के लिए बनाए गए व्यवसाय सत्र की Id। यदि रिस्पॉन्स के बाद रजिस्ट्री से जानकारी मिलती है, तो संग्रहीत रिकॉर्ड (कंसोल में दृश्यमान) अपडेट होता रहता है। registry_tier_requested: type: string enum: - basic - shareholders - ubo description: >- यह endpoint जो स्तर बेचता है: चुनिंदा के लिए `basic` (Lite), `shareholders`, `ubo`। registry_tier_delivered: type: string enum: - basic - shareholders - ubo description: >- वास्तव में डिलीवर और बिल किया गया स्तर। अनुरोध किए गए स्तर से कम तब होता है जब देश की रजिस्ट्रियों में कोई स्वामित्व डेटा नहीं होता है, या रजिस्ट्री में इस कंपनी के लिए कोई स्वामित्व रिकॉर्ड नहीं होता है। kyb_registry: type: object description: पूर्ण रजिस्ट्री कंपनी प्रोफ़ाइल। properties: uuid: type: string format: uuid description: इस कंपनी रिकॉर्ड के लिए Didit की id। node_id: type: string example: feature_kyb_registry status: type: string enum: - Not Finished - Approved - Declined - In Review description: >- रजिस्ट्री जांच पर Didit का मूल्यांकन (उदा. `In Review` जब कंपनी रजिस्ट्री में सक्रिय नहीं है या स्वामित्व डेटा प्राप्त नहीं किया जा सका)। registry_status: type: string nullable: true enum: - active - dissolved - deregistered - see full details - authorised - appointed representative - unauthorised - inactive - no longer authorised - closed - struck off description: >- रजिस्ट्री द्वारा रिपोर्ट की गई कंपनी की सामान्यीकृत स्थिति। data_resolved: type: boolean description: >- रजिस्ट्री द्वारा पूर्ण प्रोफ़ाइल लौटाने के बाद `true`। `false` जब पोलिंग के बाद भी रजिस्ट्री प्रक्रिया कर रही थी — रजिस्ट्री का समाधान होते ही संग्रहीत रिकॉर्ड स्वचालित रूप से पूरा हो जाता है। company_name: type: string example: Tesco PLC registration_number: type: string nullable: true example: '00445790' country_code: type: string description: ISO 3166-1 alpha-2। example: GB region: type: string nullable: true description: >- रजिस्ट्री के क्षेत्रीय होने पर सबडिवीजन कोड (जैसे `US-CA` के लिए `CA`); अन्यथा खाली। company_type: type: string nullable: true example: Public Limited Company incorporation_date: type: string format: date nullable: true example: '1947-11-27' registered_address: type: string nullable: true example: >- Tesco House, Shire Park, Kestrel Way, Welwyn Garden City, United Kingdom, AL7 1GA tax_number: type: string nullable: true example: GB412 8925 93 risk_level: type: string nullable: true description: >- रजिस्ट्री द्वारा रिपोर्ट किया गया जोखिम स्तर, जब उपलब्ध हो। verification_status: type: string enum: - verified - failed - unknown nullable: true description: >- क्रॉस-क्षेत्राधिकार सत्यापन स्थिति: जब रजिस्ट्री स्थिति कंपनी के अच्छी स्थिति में होने की पुष्टि करती है (`active`) तो `verified`, जब यह दर्शाती है कि कंपनी अब अच्छी स्थिति में नहीं है (उदाहरण के लिए `dissolved`) तो `failed`, अन्यथा `unknown`। रजिस्ट्री से न आई कंपनी के लिए और चयन के अभी भी `pending` रहने के दौरान `null`। is_from_registry: type: boolean description: >- इस endpoint के लिए हमेशा `true` — प्रोफ़ाइल आधिकारिक रजिस्ट्री से प्राप्त की गई थी। fetch_status: type: string enum: - pending - resolved description: >- रजिस्ट्री फ़ेच लाइफ़साइकिल। `data_resolved` द्वारा प्रतिबिंबित। alternative_names: type: string nullable: true description: >- वैकल्पिक, व्यापारिक, पूर्व या मूल-भाषा कंपनी के नाम टेक्स्ट के रूप में, जब रिपोर्ट किए गए हों। nature_of_business: type: string nullable: true description: गतिविधि विवरण या वर्गीकरण कोड, जब रिपोर्ट किया गया हो। registered_capital: type: string nullable: true registered_capital_amount: type: string nullable: true description: स्ट्रिंग के रूप में दशमलव राशि, जब रिपोर्ट की गई हो। registered_capital_currency: type: string nullable: true description: ISO 4217 कोड, रिपोर्ट किए जाने पर। website: type: string nullable: true example: https://www.tesco.com/ email: type: string nullable: true example: customer.service@tesco.co.uk phone: type: string nullable: true example: '03301231688' legal_entity_identifier: type: string nullable: true description: LEI, जब रिपोर्ट किया गया हो। location_of_registration: type: string nullable: true description: >- रजिस्ट्री/क्षेत्राधिकार जहां कंपनी पंजीकृत है, जब रिपोर्ट किया गया हो। vat_number: type: string nullable: true description: >- EU VAT संख्या, जब होस्टेड रजिस्ट्री चरण के दौरान एकत्र की गई हो या बाद में संपादित की गई हो। चयन के समय यह आमतौर पर अभी तक सेट नहीं होती है — VAT और कर पहचान संख्या सत्यापन तब चलता है जब अंतिम उपयोगकर्ता होस्टेड फ़्लो में रजिस्ट्री चरण सबमिट करता है। vat_validation_status: type: string enum: - valid - invalid - format_valid - invalid_format - could_not_validate - not_applicable description: >- रजिस्ट्री सबमिट पर VAT संख्या या, यदि कोई नहीं है, तो `tax_number` के सत्यापन का परिणाम। `valid` / `invalid`: देश की आधिकारिक रजिस्ट्री द्वारा तय किया जाता है (EU VIES, नॉर्वे, स्विट्जरलैंड, ब्राजील, कोलंबिया, कोस्टा रिका, इक्वाडोर, पराग्वे; पोलैंड अपने घरेलू VAT रजिस्टर द्वारा भी)। `format_valid` / `invalid_format`: देश के प्रारूप और चेक-डिजिट नियमों द्वारा तय किया जाता है जहाँ किसी रजिस्ट्री से क्वेरी नहीं की जा सकती। `could_not_validate`: रजिस्ट्री अनुपलब्ध थी। `not_applicable`: कोई संख्या नहीं, बिना रजिस्ट्री या नियमों वाला देश, या कोई सैंडबॉक्स सत्र। vat_validated_number: type: string nullable: true description: >- वह संख्या जिसकी जाँच की गई थी, जैसा कि स्रोत इसे जानता है (उदाहरण के लिए फ्रेंच SIREN या डच RSIN से प्राप्त VAT संख्या)। कोई जाँच न चलने पर `null`। vat_validation_source: type: string nullable: true enum: - eu_vies - pl_vat_white_list - no_brreg - ch_uid_register - br_receita_federal - co_rues - cr_hacienda - ec_sri - py_dnit - format_rules - null description: >- वह स्रोत जिसने `vat_validation_status` तय किया: एक आधिकारिक रजिस्ट्री, या `format_rules`। कोई जाँच न चलने पर `null`। vat_validated_name: type: string nullable: true description: >- नंबर को सत्यापित करने वाले स्रोत के साथ पंजीकृत नाम, जब वह इसे प्रकट करता है। केवल तब सेट होता है जब स्थिति `valid` हो। vat_validated_address: type: string nullable: true description: >- नंबर को सत्यापित करने वाले स्रोत के पास पंजीकृत पता, यदि वह इसे प्रकट करता है। केवल तभी सेट किया जाता है जब स्थिति `valid` हो। vat_checked_at: type: string format: date-time nullable: true description: जांच का टाइमस्टैम्प। कोई जांच न चलने पर `null`। financial_summary: type: object nullable: true description: >- रजिस्ट्री द्वारा रिपोर्ट किए गए शेयर/पूंजी विवरण (मुद्रा, कुल शेयर, शेयर वर्ग), जब उपलब्ध हों। officers: type: array items: type: object properties: uuid: type: string format: uuid name: type: string example: MELISSA BETHELL designation: type: string nullable: true description: >- रजिस्ट्री से प्राप्त रॉ पदनाम (उदा. `Director`, `Secretary`)। role: type: string description: >- पदनाम से प्राप्त सामान्यीकृत भूमिका। पूर्ण 17-मान मॉडल सेट; इस endpoint पर रजिस्ट्री पार्सिंग आमतौर पर director, non_executive_director, secretary, chairman, या company_officer उत्सर्जित करती है। enum: - director - non_executive_director - secretary - chairman - ubo - shareholder - representative - founder - legal_advisor - authorized_signatory - trustee - beneficiary - company_officer - settlor - protector - investor - other nationality: type: string nullable: true is_active: type: boolean description: >- `false` जब रजिस्ट्री नियुक्ति को इस्तीफ़ा दिया हुआ चिह्नित करती है। kyc_status: type: string nullable: true enum: - Approved - Declined - Pending description: >- संबंधित KYC सत्र की स्थिति, जब इस अधिकारी के लिए कोई सत्र शुरू किया गया हो। अन्यथा `null`। kyc_session_url: type: string nullable: true description: संबद्ध KYC सत्र का सत्यापन URL, जब कोई मौजूद हो। first_name: type: string nullable: true description: >- पहला नाम जब रजिस्ट्री द्वारा स्पष्ट रूप से रिपोर्ट किया गया हो; पूरे नाम से अनुमानित नहीं। last_name: type: string nullable: true description: >- कुलनाम जब रजिस्ट्री द्वारा स्पष्ट रूप से रिपोर्ट किया गया हो। address: type: string nullable: true description: >- रजिस्ट्री द्वारा रिपोर्ट किया गया अधिकारी का पता। appointment_date: type: string nullable: true description: अधिकारी की नियुक्ति की तारीख। format: date termination_date: type: string nullable: true description: >- नियुक्ति समाप्त होने की तारीख, जब रिपोर्ट की गई हो। format: date date_of_birth: type: string nullable: true description: >- रजिस्ट्री द्वारा रिपोर्ट की गई पूरी जन्म तिथि। केवल जन्म वर्ष या माह ज्ञात होने पर Null। format: date date_of_birth_year: type: integer nullable: true minimum: 1 maximum: 9999 description: >- रजिस्ट्री द्वारा रिपोर्ट किया गया जन्म वर्ष, जिसमें पूर्ण तिथि अनुपलब्ध होने की स्थिति भी शामिल है। date_of_birth_month: type: integer nullable: true minimum: 1 maximum: 12 description: >- रजिस्ट्री द्वारा रिपोर्ट किया गया जन्म का महीना। केवल वर्ष ज्ञात होने पर Null। description: रजिस्ट्री से निकाले गए निदेशक, सचिव और अन्य अधिकारी। beneficial_owners: type: array items: type: object properties: uuid: type: string format: uuid name: type: string first_name: type: string nullable: true last_name: type: string nullable: true entity_type: type: string enum: - person - company description: >- क्या स्वामी कोई प्राकृतिक व्यक्ति है या कॉर्पोरेट इकाई। roles: type: array items: type: string description: >- सामान्यीकृत भूमिकाएँ (उदा. `ubo`, `shareholder`)। ownership_min_shares: type: string nullable: true description: >- रजिस्ट्री द्वारा रिपोर्ट किए गए स्वामित्व बैंड की निचली सीमा (उदा. `25%`)। ownership_max_shares: type: string nullable: true description: >- रजिस्ट्री द्वारा रिपोर्ट किए गए स्वामित्व बैंड की ऊपरी सीमा। is_active: type: boolean kyc_status: type: string enum: - Approved - Declined - Pending nullable: true kyc_session_url: type: string nullable: true effective_ownership_percent: type: number nullable: true description: >- पार्स किया गया स्वामित्व प्रतिशत (अधिकतम सीमा, न्यूनतम सीमा पर फ़ॉलबैक)। company_name: type: string nullable: true registration_number: type: string nullable: true country_of_birth: type: string nullable: true email: type: string nullable: true nationality: type: string nullable: true designation: type: string nullable: true voting_min_shares: type: string nullable: true voting_max_shares: type: string nullable: true date_of_birth: type: string nullable: true description: रिपोर्ट किए जाने पर पूरी जन्म तिथि। format: date appointment_date: type: string nullable: true description: रिपोर्ट किए जाने पर नियुक्ति तिथि। format: date shareholding: $ref: '#/components/schemas/KYBRegistryShareholding' description: >- रजिस्ट्री से निकाले गए वास्तविक स्वामी / महत्वपूर्ण नियंत्रण वाले व्यक्ति। जब रजिस्ट्री स्वामित्व को उजागर नहीं करती है तो खाली हो सकता है। addresses: type: array nullable: true description: >- रजिस्ट्री द्वारा उल्लिखित प्रत्येक पता, एक कैनोनिकल स्वरूप में। यदि कोई उल्लिखित नहीं है तो Null। items: $ref: '#/components/schemas/KYBRegistryAddress' industries: type: array nullable: true description: >- वे गतिविधियाँ जिनके तहत रजिस्ट्री कंपनी को वर्गीकृत करती है, एक विहित आकार। जब यह कोई गतिविधि नहीं बताती है तब null। items: $ref: '#/components/schemas/KYBRegistryIndustry' accounts: type: object nullable: true additionalProperties: true description: >- रजिस्ट्री फ़ाइलिंग तिथियां, जब उपलब्ध हों। वार्षिक रिटर्न और आम बैठकों के लिए last_annual_return_date और last_agm_date का उपयोग किया जाता है; वे वित्तीय खातों से भिन्न होते हैं। registry_data: $ref: '#/components/schemas/KYBRegistryData' user_provided_data: type: object nullable: true description: >- इस endpoint पर हमेशा `null` (होस्टेड KYB फ़्लो द्वारा उपयोग किया जाता है जब अंतिम उपयोगकर्ता रजिस्ट्री डेटा संपादित करते हैं)। confirmed_by_user_at: type: string format: date-time nullable: true description: इस endpoint पर हमेशा `null`। last_console_edit_at: type: string format: date-time nullable: true description: >- तब सेट किया जाता है जब कोई कंसोल समीक्षक बाद में रिकॉर्ड को संपादित करता है। is_editable: type: boolean description: >- क्या रजिस्ट्री से प्राप्त डेटा को अभी भी होस्टेड फ़्लो/कंसोल में संपादित किया जा सकता है। registry_tier_delivered: type: string enum: - basic - shareholders - ubo description: शीर्ष-स्तरीय `registry_tier_delivered` के समान। registry_ownership_status: type: string nullable: true enum: - not_requested - delivered - not_held - unavailable description: >- `delivered` जब स्वामित्व डेटा वापस मिल गया, `not_held` जब स्वामित्व रजिस्ट्री ने उत्तर दिया और इस कंपनी को सूचीबद्ध नहीं करती है (`registry_data.ownership_error` देखें), `unavailable` जब स्वामित्व स्तर का अनुरोध किया गया था लेकिन रजिस्ट्री के पास इस कंपनी के लिए कोई डेटा नहीं था या पूछा नहीं जा सका (`registry_data.ownership_error` देखें), Lite स्तर पर `not_requested`। ownership: $ref: '#/components/schemas/KYBRegistryOwnership' registry_tier: type: string nullable: true description: >- वर्कफ़्लो द्वारा आदेशित रजिस्ट्री स्तर: `basic`, `shareholders` या `ubo`। `ownership.tier_requested` में भी। registry_monitoring: type: object nullable: true description: >- कंपनी के लिए नवीनतम रजिस्ट्री मॉनिटर, या कोई मौजूद न होने पर `null`। properties: uuid: type: string format: uuid status: type: string unavailable_reason: type: string nullable: true enrolled_at: type: string format: date-time nullable: true cancelled_at: type: string format: date-time nullable: true last_bill_date: type: string format: date nullable: true next_bill_date: type: string format: date nullable: true last_event_at: type: string format: date-time nullable: true events_count: type: integer watched_fields: description: कंपनी के वे फ़ील्ड जिन पर मॉनिटर नज़र रखता है। vendor_data: type: string nullable: true description: आपके द्वारा भेजे गए `vendor_data` का इको। metadata: type: object nullable: true description: आपके द्वारा भेजे गए `metadata` का इको। created_at: type: string format: date-time examples: Resolved company: summary: >- पूर्ण रजिस्ट्री प्रोफ़ाइल (संक्षिप्तता के लिए अधिकारी सूची छोटी की गई है) value: request_id: 9d4f2c7a-1b3e-4a5c-8d6f-0e9a8b7c6d5e kyb_registry: uuid: f1e2d3c4-b5a6-4789-9c0d-1e2f3a4b5c6d node_id: feature_kyb_registry status: In Review registry_status: active data_resolved: true company_name: Tesco PLC registration_number: '00445790' country_code: GB region: '' company_type: Public Limited Company incorporation_date: '1947-11-27' registered_address: >- Tesco House, Shire Park, Kestrel Way, Welwyn Garden City, United Kingdom, AL7 1GA tax_number: GB412 8925 93 risk_level: low risk verification_status: verified is_from_registry: true fetch_status: resolved alternative_names: TESCO STORES (HOLDINGS) PUBLIC LIMITED COMPANY nature_of_business: null registered_capital: null registered_capital_amount: null registered_capital_currency: null website: https://www.tesco.com/ email: customer.service@tesco.co.uk phone: '03301231688' legal_entity_identifier: null location_of_registration: null financial_summary: currency: Pound (£) total_number_of_shares: '8174378721' meta_detail: Class_Of_Share: Ordinary officers: - uuid: a1b2c3d4-e5f6-4789-9a0b-1c2d3e4f5a6b name: CHRISTOPHER JON TAYLOR designation: Secretary role: secretary nationality: null is_active: true kyc_status: null kyc_session_url: null - uuid: b2c3d4e5-f6a7-4890-8b1c-2d3e4f5a6b7c name: MELISSA BETHELL designation: Director role: director nationality: British is_active: true kyc_status: null kyc_session_url: null beneficial_owners: [] addresses: - address: >- Tesco House, Shire Park, Kestrel Way, Welwyn Garden City, United Kingdom, AL7 1GA type: legal_entity_registry_address description: registered office address industries: null accounts: last_account: 26 February 2025 next_account: 26 February 2026 due_by_date: 26 August 2026 registry_data: {} user_provided_data: null confirmed_by_user_at: null last_console_edit_at: null is_editable: true vendor_data: company-1234 metadata: null created_at: '2026-06-11T10:45:00.000000+00:00' Pending (registry still resolving): summary: >- पोलिंग के बाद चयन पेंडिंग रहा — स्पार्स फ़ील्ड, सर्वर-साइड अपने-आप पूरे हो जाते हैं value: request_id: 9d4f2c7a-1b3e-4a5c-8d6f-0e9a8b7c6d5e kyb_registry: uuid: 7c0a4f7e-2b1d-4f6a-9c3e-8d5b2a1f0e9d node_id: feature_kyb_registry status: Not Finished registry_status: null data_resolved: false company_name: Tesco PLC registration_number: '00445790' country_code: GB region: null company_type: null incorporation_date: null registered_address: null tax_number: null risk_level: null verification_status: null is_from_registry: true fetch_status: pending alternative_names: null nature_of_business: null registered_capital: null registered_capital_amount: null registered_capital_currency: null website: null email: null phone: null legal_entity_identifier: null location_of_registration: null financial_summary: {} officers: [] beneficial_owners: [] addresses: null industries: null accounts: null registry_data: {} user_provided_data: null confirmed_by_user_at: null last_console_edit_at: null is_editable: true vendor_data: company-1234 metadata: null created_at: '2026-06-11T10:45:00.000000+00:00' '400': description: >- सत्यापन त्रुटि। फ़ील्ड-स्तरीय समस्याएं DRF के मानक एनवेलप का उपयोग करती हैं। ऐसा देश जिसे रजिस्ट्रियां कवर नहीं करती हैं, वह `code: kyb_registry_country_unsupported` के साथ `400` रिस्पॉन्स देता है। content: application/json: examples: Missing kyb_response_id: summary: '`kyb_response_id` आवश्यक है' value: kyb_response_id: - This field is required. save_api_request=false rejected: summary: चयन हमेशा बने रहते हैं value: save_api_request: - >- KYB registry select must be saved so billing and retrieval can be tracked. Country not covered: summary: कोई भी कंपनी रजिस्ट्री इस देश को कवर नहीं करती है value: detail: >- Company registry search is not available for this country. Enter the company details manually to continue. code: kyb_registry_country_unsupported '403': description: >- अनुमति अस्वीकृत। तब लौटाया जाता है जब `x-api-key` हेडर अनुपलब्ध हो, और तब भी जब कॉल करने वाले संगठन का बैलेंस कॉल को कवर नहीं कर सकता; गलत, निरस्त या समय-सीमा समाप्त कुंजी `401` लौटाती है। अनुपलब्ध कुंजी `{"detail": ...}` के साथ `403` लौटाती है; गलत, निरस्त या समय-सीमा समाप्त कुंजी `401` लौटाती है। क्रेडिट की कमी किसी भी स्क्रीनिंग या प्रदाता कॉल से पहले `{"error": ...}` के साथ `403` लौटाती है। content: application/json: examples: Missing or invalid API key: summary: कोई `x-api-key` हेडर नहीं, या कुंजी अमान्य/निरस्त है value: detail: You do not have permission to perform this action. Not enough credits: summary: संगठन का बैलेंस कॉल को कवर नहीं कर सकता value: error: >- You don't have enough credits to perform this request. Please top up at https://business.didit.me '429': description: >- रेट लिमिट पार हो गई। POST/PATCH/DELETE endpoints प्रति मिनट प्रति API कुंजी 300 राइट अनुरोधों का बजट साझा करते हैं (लेन-देन निर्माण और इवेंट इनजेशन का 600 का एक अलग बजट है)। रिस्पॉन्स में `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset` और `Retry-After` हेडर होते हैं। content: application/json: examples: Write rate limit exceeded: summary: वर्तमान मिनट में 300 से अधिक राइट अनुरोध value: detail: >- Write request rate limit exceeded. You can make up to 300 requests per minute. schema: type: object properties: detail: type: string security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: |- curl -X POST https://verification.didit.me/v3/kyb/select/ \ -H 'x-api-key: YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{ "kyb_response_id": "69aeeb95febb0f1704042259", "vendor_data": "company-1234" }' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.kyb.select( kyb_response_id="69aeeb95febb0f1704042259", vendor_data="company-1234", ) print(result) - lang: javascript label: Node.js source: |- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); const result = await didit.kyb.select({ kyb_response_id: "69aeeb95febb0f1704042259", vendor_data: "company-1234", }); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.KYB.Select(ctx, didit.KYBRegistryCandidateRequest{\n\tKYBResponseID: \"69aeeb95febb0f1704042259\",\n\tVendorData: didit.String(\"company-1234\"),\n})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: >- import me.didit.Didit; import me.didit.types.KYBRegistryCandidateRequest; // Reads DIDIT_API_KEY. Didit client = new Didit(); var result = client.kyb().select(KYBRegistryCandidateRequest.builder() .kybResponseId("69aeeb95febb0f1704042259") .vendorData("company-1234") .build()); System.out.println(result); - lang: php label: PHP source: |- kyb->select([ 'kyb_response_id' => '69aeeb95febb0f1704042259', 'vendor_data' => 'company-1234', ]); print_r($result->toArray()); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.kyb.select( kyb_response_id: "69aeeb95febb0f1704042259", vendor_data: "company-1234" ) puts result.to_h - lang: csharp label: .NET source: >- using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); var result = await client.Kyb.SelectAsync(new KYBRegistryCandidateRequest { KybResponseId = "69aeeb95febb0f1704042259", VendorData = "company-1234", }); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: KYBRegistryCandidateRequest: type: object required: - kyb_response_id properties: kyb_response_id: type: string maxLength: 1024 description: >- `POST /v3/kyb/search/` (`kyb_registry.companies[].kyb_response_id`) से कैंडिडेट हैंडल। अल्पकालिक: इसे उत्पन्न करने वाली खोज के तुरंत बाद उपयोग करें। हैंडल लंबे हो सकते हैं, इसलिए मान को बिना ट्रिम किए या लंबाई का अनुमान लगाए ठीक उसी तरह स्टोर करें और भेजें जैसा कि लौटाया गया है। example: 69aeeb95febb0f1704042259 vendor_data: type: string description: >- इस कंपनी के लिए आपका पहचानकर्ता; वापस दोहराया जाता है और व्यवसाय सत्र के साथ संग्रहीत किया जाता है। metadata: type: object nullable: true description: व्यवसाय सत्र के साथ संग्रहीत और वापस लौटाया गया फ़्री-फ़ॉर्म JSON। save_api_request: type: boolean default: true description: >- `true` होना चाहिए (डिफ़ॉल्ट)। KYB रजिस्ट्री चयन हमेशा बनाए रखे जाते हैं ताकि बिलिंग और पुनर्प्राप्ति को ट्रैक किया जा सके; `false` `400` लौटाता है। KYBRegistryShareholding: type: object nullable: true description: >- स्वामी के पास क्या धारिता है, प्रत्येक देश और रजिस्ट्री स्रोत के लिए समान स्वरूप में। जब रजिस्ट्री में किसी धारिता का उल्लेख न हो तो Null। एक बैंड (उदाहरण के लिए UK PSC का 25-50%) हिस्सेदारी नहीं है: `percentage` null है और बैंड `ownership_min_shares` / `ownership_max_shares` में रहता है। properties: share_class: type: string nullable: true description: शेयर वर्ग या प्रकार जैसा कि रजिस्ट्री में नामित है। number_of_shares: type: number nullable: true description: धारित शेयरों की संख्या। currency: type: string nullable: true description: नीचे दिए गए मानों की ISO 4217 करेंसी। nominal_value: type: number nullable: true description: प्रति शेयर अंकित मूल्य। total_value: type: number nullable: true description: होल्डिंग का कुल मूल्य। percentage: type: number nullable: true description: दशमलव के चार स्थानों तक प्रतिशत में सटीक हिस्सेदारी। required: - share_class - number_of_shares - currency - nominal_value - total_value - percentage KYBRegistryAddress: type: object description: >- एक पता जो रजिस्ट्री बताती है, प्रत्येक देश और रजिस्ट्री स्रोत के लिए समान संरचना में। प्रत्येक कुंजी हमेशा मौजूद होती है; वह भाग जिसे रजिस्ट्री प्रकाशित नहीं करती है, null होता है। properties: type: type: string nullable: true description: >- लोअरकेस में पते का प्रकार: पंजीकृत कार्यालय के लिए `registered`; अन्य प्रकार जैसा कि रजिस्ट्री उन्हें नाम देती है (उदाहरण के लिए `postal`, `office`)। जब रजिस्ट्री यह नहीं बताती कि पता क्या है, तब `null`। address: type: string description: एक पंक्ति के रूप में पूरा पता। प्रत्येक पते पर हमेशा मौजूद रहता है। street: type: string nullable: true description: सड़क और संख्या। city: type: string nullable: true description: शहर या इलाका। postal_code: type: string nullable: true description: डाक कोड। region: type: string nullable: true description: क्षेत्र, राज्य या प्रांत। country_code: type: string nullable: true description: ISO 3166-1 alpha-2 देश कोड। description: type: string nullable: true description: पते के लिए रजिस्ट्री का अपना लेबल, जब वह कोई लेबल प्रदान करती है। required: - type - address - street - city - postal_code - region - country_code - description KYBRegistryIndustry: type: object description: >- एक गतिविधि जिसके तहत रजिस्ट्री कंपनी को वर्गीकृत करती है, प्रत्येक देश और रजिस्ट्री स्रोत के लिए समान संरचना में। properties: code: type: string nullable: true description: >- गतिविधि कोड जैसा कि रजिस्ट्री इसे प्रिंट करती है (उदाहरण के लिए `73110`)। description: type: string nullable: true description: गतिविधि लेबल, जब रजिस्ट्री इसे प्रकाशित करती है। scheme: type: string nullable: true description: >- वर्गीकरण प्रणाली, प्रत्येक प्रणाली के लिए एक नाम, चाहे जिस भी स्रोत ने इसे रिपोर्ट किया हो: `UK SIC 2007`, `US SIC`, `NACE Rev. 2`, `NACE Rev. 2.1`, `NAF Rev. 2`, `CNAE`, `SBI`, `NOGA 2008`, `CAE Rev. 4`, `Canada SIC 1977`; अन्य राष्ट्रीय प्रणालियां रजिस्ट्री का अपना नाम बनाए रखती हैं। जब रजिस्ट्री प्रणाली का नाम नहीं देती है, तो Null। is_primary: type: boolean description: >- कंपनी की मुख्य गतिविधि के लिए True। सूची खाली न होने पर ठीक एक प्रविष्टि प्राथमिक होती है। required: - code - description - scheme - is_primary KYBRegistryData: type: object nullable: true description: >- कंपनी के लिए Didit का सामान्यीकृत रजिस्ट्री विवरण: स्वामित्व परिणाम (`ownership_error`, `section_errors`, `ubo_resolution`, `lite_enrichment`), update-data के साथ किए गए सुधार, और रजिस्ट्री तथ्य जिनका अपना कोई फ़ील्ड नहीं है। इसमें कभी भी रजिस्ट्री स्रोत का अपना रिकॉर्ड शामिल नहीं होता है। प्रत्येक कुंजी वैकल्पिक है और केवल तभी मौजूद होती है जब कंपनी के पास इसके लिए कोई मान हो; नई कुंजियाँ जोड़ी जा सकती हैं। उनके अंतर्गत आने वाली किसी भी चीज़ के लिए कैनोनिकल फ़ील्ड (`addresses`, `industries`, `ownership`, `beneficial_owners[].shareholding`) पढ़ें। properties: company_name: type: string description: कंपनी का नाम जैसा कि कंसोल में ठीक किया गया है। registration_number: type: string description: पंजीकरण संख्या जैसा कि रजिस्ट्री या कंसोल सुधार में बताया गया है। country_code: type: string description: पंजीकरण का देश, जैसा कि रजिस्ट्री या कंसोल सुधार में बताया गया है। region: type: string description: पंजीकरण का क्षेत्र या राज्य। incorporation_date: type: string description: निगमन तिथि (ISO 8601)। registration_date: type: string description: पंजीकरण तिथि (ISO 8601) जब रजिस्ट्री इसे निगमन तिथि से अलग बताती है। dissolution_date: type: string description: विघटन तिथि (ISO 8601) जब रजिस्ट्री में उल्लिखित हो। tax_number: type: string description: कर पहचान संख्या। vat_number: type: string description: VAT नंबर। legal_address: type: string description: कंसोल में सही किया गया कानूनी पता। registered_address: type: string description: रजिस्ट्री में जैसा दर्ज है, वैसा पंजीकृत पता। company_type: type: string description: कानूनी रूप। registry_status: type: string description: रजिस्ट्री में कंपनी की स्थिति। verification_status: type: string description: सत्यापन स्थिति। alternative_names: type: string description: अन्य नाम जिनसे कंपनी कारोबार करती है या करती थी। nature_of_business: type: string description: गतिविधि विवरण। registered_capital: type: string description: मुद्रित रूप में पंजीकृत पूंजी। registered_capital_amount: type: string description: पंजीकृत पूंजी राशि, दशमलव स्ट्रिंग के रूप में। registered_capital_currency: type: string description: पंजीकृत पूंजी की मुद्रा (ISO 4217)। website: type: string description: वेबसाइट। email: type: string description: संपर्क ईमेल। phone: type: string description: संपर्क फ़ोन। legal_entity_identifier: type: string description: लीगल एंटिटी आइडेंटिफ़ायर (LEI)। location_of_registration: type: string description: पंजीकरण का स्थान। control_scheme: type: string description: गवर्नेंस योजना जब रजिस्ट्री इसे प्रदर्शित करती है। ownership_error: type: string enum: - no_owners_on_record - no_natural_person_owner - ownership_section_unavailable - company_not_found - ambiguous_company_match - missing_registration_number - entity_type_not_covered - provider_unavailable - other description: >- अनुरोधित स्वामित्व स्तर क्यों डिलीवर नहीं किया गया, `ownership.unavailable_reason` के समान कोड में। `no_owners_on_record` (रजिस्ट्री ने उत्तर दिया और किसी स्वामी का नाम नहीं दिया) और `ownership_section_unavailable` (रजिस्ट्री ने स्वामित्व अनुभाग नहीं लौटाया) अलग-अलग निष्कर्ष हैं। section_errors: type: object description: >- वे अनुभाग जो रजिस्ट्री ने नहीं लौटाए, अनुभाग के आधार पर कुंजीबद्ध (`officers`, `shareholders`, `group_structure`)। यहाँ सूचीबद्ध अनुभाग कभी डिलीवर नहीं किया गया था: इसके आगे की खाली सूची कंपनी के बारे में कुछ नहीं बताती। additionalProperties: $ref: '#/components/schemas/KYBRegistrySectionError' ubo_resolution: $ref: '#/components/schemas/KYBRegistryUboResolution' lite_enrichment: $ref: '#/components/schemas/KYBRegistryLiteEnrichment' registry_metadata: type: object additionalProperties: oneOf: - type: string - type: number - type: boolean description: >- कंपनी के लिए रजिस्ट्री के अपने फ़ील्ड, रजिस्ट्री में दिए गए उनके नामों के अनुसार, सादे मानों के रूप में (लीगेसी रिकॉर्ड)। केवल रजिस्ट्री तथ्यों के रूप में समीक्षा किए गए फ़ील्ड शामिल हैं। registry_sources: type: array description: >- आधिकारिक रजिस्टर जिनसे रिकॉर्ड पढ़ा गया था (लीगेसी रिकॉर्ड)। अन्य स्रोतों के नाम नहीं दिए गए हैं। items: $ref: '#/components/schemas/KYBRegistrySource' previous_names: type: array items: type: string description: वे नाम जिनके तहत कंपनी पहले पंजीकृत थी (लीगेसी रिकॉर्ड्स)। parent_companies: type: array items: type: string description: मूल कंपनियाँ जिनका नाम रजिस्ट्री में दर्ज है (लेगेसी रिकॉर्ड)। documents_available: type: integer description: >- कंपनी के लिए रजिस्ट्री कितनी फाइलिंग प्रदान करती है (लेगेसी रिकॉर्ड्स)। KYBRegistryOwnership: type: object description: >- स्वामित्व (शेयरधारक / UBO) स्तर का परिणाम, प्रत्येक देश और रजिस्ट्री स्रोत के लिए समान प्रारूप में। properties: status: type: string nullable: true enum: - not_requested - pending - delivered - not_held - unavailable - null description: >- `delivered` जब रजिस्ट्री ने स्वामित्व प्रकाशित किया; `not_held` जब स्वामित्व रजिस्ट्री ने उत्तर दिया और कंपनी को बिल्कुल भी सूचीबद्ध नहीं करती है (`unavailable_reason` देखें); `unavailable` जब इसने किसी अन्य कारण से स्वामित्व डेटा प्रदान नहीं किया (`unavailable_reason` देखें); `pending` जबकि रजिस्ट्री अभी भी इसे प्राप्त कर रही है; Basic स्तर के लिए `not_requested`। tier_requested: type: string nullable: true enum: - basic - shareholders - ubo - null description: वर्कफ़्लो द्वारा ऑर्डर किया गया स्तर। tier_delivered: type: string nullable: true enum: - basic - shareholders - ubo - null description: >- वह स्तर जो रजिस्ट्री ने डिलीवर किया है (और जिसे बिल किया जाता है)। केवल प्रत्यक्ष शेयरधारकों के साथ उत्तर दिया गया UBO अनुरोध `shareholders` होता है। unavailable_reason: type: string nullable: true enum: - no_owners_on_record - no_natural_person_owner - ownership_section_unavailable - company_not_found - ambiguous_company_match - missing_registration_number - entity_type_not_covered - provider_unavailable - other - null description: >- अनुरोधित स्वामित्व स्तर क्यों डिलीवर नहीं किया गया। जब तक `status`, `unavailable` या `pending` न हो, तब तक Null। direct_ownership_complete: type: boolean nullable: true description: >- True जब प्रत्यक्ष शेयरधारकों के घोषित हिस्से कुल मिलाकर 100% होते हैं (राउंडिंग के एक प्रतिशत बिंदु के भीतर); false जब वे ऐसा नहीं करते हैं; null जब स्वामित्व डिलीवर नहीं किया गया था या कोई हिस्सा घोषित नहीं है। unresolved: type: array description: >- स्वामित्व शृंखला के वे भाग जिन्हें रजिस्ट्री हल नहीं कर सकी, उदाहरण के लिए प्रत्यक्ष स्वामियों के ऊपर रिकॉर्ड में कोई समूह संरचना न होना। items: type: object properties: reason: type: string section: type: string nullable: true required: - status - tier_requested - tier_delivered - unavailable_reason - direct_ownership_complete - unresolved KYBRegistrySectionError: type: object description: एक ऐसा अनुभाग जिसे रजिस्ट्री ने वापस नहीं किया। properties: status_code: type: integer nullable: true description: वह स्थिति जो रजिस्ट्री ने अनुभाग के लिए उत्तर में दी। required: - status_code KYBRegistryUboResolution: type: object description: UBO स्तर ने कंपनी के ऊपर स्वामित्व श्रृंखला को कैसे पार किया। properties: parent_chain: type: array description: अंतिम मूल कंपनी से लेकर कंपनी तक के कॉर्पोरेट पैरेंट्स। items: $ref: '#/components/schemas/KYBRegistryGroupCompany' subsidiaries: type: array description: कंपनी के कॉर्पोरेट समूह में सीधे उसके नीचे की कंपनियाँ। items: $ref: '#/components/schemas/KYBRegistryGroupCompany' unresolved: type: array description: >- शृंखला के वे भाग जिन्हें रजिस्ट्री हल नहीं कर सकी (`ownership.unresolved` के समान प्रविष्टियाँ)। items: type: object properties: reason: type: string description: >- कारण, उदाहरण के लिए `no_group_structure_on_record`, `selected_company_not_in_group_structure` या `section_error`। section: type: string nullable: true description: संबंधित अनुभाग, उदाहरण के लिए `group_structure`। required: - reason - section required: - parent_chain - subsidiaries - unresolved KYBRegistryLiteEnrichment: type: object description: >- खाली Lite प्रोफ़ाइल फ़ील्ड जिन्हें देश के किसी अन्य रजिस्ट्री स्रोत ने भरा है। स्रोत का नाम नहीं दिया गया है। properties: fields: type: array items: type: string description: कंपनी के वे फ़ील्ड जो भरे गए थे। people_added: type: integer description: कितने अधिकारियों या स्वामियों को जोड़ा गया। required: - fields - people_added KYBRegistrySource: type: object description: >- एक आधिकारिक रजिस्टर जिससे रिकॉर्ड पढ़ा गया था। केवल आधिकारिक सरकारी रजिस्टरों, नियामकों और आधिकारिक पहचानकर्ता प्रणाली का नाम दिया गया है; किसी अन्य स्रोत को छोड़ दिया गया है। properties: name: type: string description: रजिस्टर का नाम, उदाहरण के लिए `UK Companies House`। source_type: type: string enum: - official description: हमेशा `official`। required: - name - source_type KYBRegistryGroupCompany: type: object description: कॉर्पोरेट समूह की एक कंपनी, उसकी रजिस्ट्री पहचान द्वारा। properties: name: type: string nullable: true description: कंपनी का नाम। country_code: type: string nullable: true description: पंजीकरण का देश। registration_number: type: string nullable: true description: पंजीकरण संख्या। required: - name - country_code - registration_number securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- आपकी एप्लिकेशन की 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। ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.