> ## 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. # व्यवसाय प्राप्त करें API: विक्रेता KYB इकाई > Didit में vendor_data से एक व्यवसाय (KYB) प्राप्त करें: रजिस्ट्री-आधारित पहचान, स्थिति, KYB काउंटर और features मैप। प्रति कॉल भुगतान। व्यवसाय प्राप्त करने का प्रॉम्प्ट प्रॉम्प्ट को क्लिपबोर्ड पर कॉपी करें \

\`Goal: Fetch a single Didit Business (KYB) entity by your own vendor_data.

Endpoint: GET https://verification.didit.me/v3/businesses/{vendor_data}/
Auth header: x-api-key: 

Path param:
\- vendor_data (string, REQUIRED) — your unique identifier. Free-form string, NOT a UUID. Matching is case-insensitive after normalisation. URL-encode it.

curl:
curl -X GET 'https://verification.didit.me/v3/businesses/company-123/' \
-H 'x-api-key: YOUR_API_KEY'

Response 200 (BusinessDetailItem) — extends the list shape with metadata, comments (activity log), and updated_at. Key fields:
\- didit_internal_id (UUID — Didit's stable internal identifier)
\- vendor_data (string)
\- display_name, legal_name, registration_number, country_code, region, effective_name
\- status: "ACTIVE" | "FLAGGED" | "BLOCKED" (VendorBusinessStatusChoices)
\- session_count, approved_count, declined_count, in_review_count (aggregate counters)
\- features (map: KYB_REGISTRY, KYB_AML, KYB_DOCUMENTS, ... -> latest status)
\- metadata (arbitrary JSON you attached)
\- comments (chronological activity log)
\- tags, created_at, updated_at, last_activity_at
See /reference/data-models for the full schema.

Notes:
\- Aggregate counters update in real time as Business Verification (KYB) sessions reach terminal status.
\- Registry-derived fields reflect the latest approved KYB session's registry data.
\- For bulk lookups, prefer paging GET /v3/businesses/ and indexing locally on vendor_data.

Failure modes (envelope {"detail": "..."}):
\- 401 — missing/invalid x-api-key.
\- 403 — lacks read:businesses.
\- 404 — no business with that vendor_data in this application.
\- 429 — rate-limited.

For end-to-end Didit integration, paste in the full prompt at /integration/integration-prompt.`

\
यहाँ पेस्ट करें ## अवलोकन`vendor_data` से पहचाने गए एक [व्यवसाय इकाई](https://docs.didit.me/hi/entities/businesses/overview.md) की जानकारी लौटाता है।## इसे कब उपयोग करें- किसी व्यवसाय की मौजूदा सत्यापन स्थिति देखने के लिए **जांच** करें। `features` मैप आपको हर KYB फ़ीचर की नवीनतम स्थिति एक नज़र में देता है। - आपके अपने एडमिन UI में **विवरण दृश्य**। - एकत्रित काउंटर और फ़ीचर स्थितियों का उपयोग करते हुए **जोखिम स्कोरिंग**।## नोट्स- URL में `vendor_data` केस-संवेदी है। - यदि `vendor_data` वाला कोई व्यवसाय मौजूद नहीं है, तो `404` लौटाता है। - `session_count`, `approved_count`, `declined_count` और `in_review_count` वाले एकत्रित काउंटर, व्यवसाय सत्यापन (KYB) सत्र पूरे होते ही वास्तविक समय में अपडेट होते हैं। - रजिस्ट्री से लिए गए फ़ील्ड `legal_name`, `registration_number` और `country_code`, नवीनतम स्वीकृत व्यवसाय सत्यापन (KYB) सत्र को दर्शाते हैं।## अनुमतियाँभूमिका को `read:businesses` देनी होगी।## संबंधित- [व्यवसाय अवलोकन](https://docs.didit.me/hi/entities/businesses/overview.md) - [डेटा मॉडल](https://docs.didit.me/hi/entities/businesses/data-model.md) - [व्यवसाय सूचीबद्ध करें](https://docs.didit.me/hi/management-api/businesses/list.md) ## OpenAPI ````yaml hi/openapi-25.json GET /v3/businesses/{vendor_data}/ 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/businesses/{vendor_data}/: get: tags: - Businesses summary: व्यवसाय प्राप्त करें description: >- `vendor_data` (सटीक मिलान) द्वारा एक [व्यवसाय](/entities/businesses) प्राप्त करें। सूची दृश्य में `metadata` और `updated_at` जोड़ता है। हटाए गए व्यवसाय 404 लौटाते हैं। operationId: get_business parameters: - name: vendor_data in: path required: true schema: type: string description: >- व्यवसाय के लिए आपका विशिष्ट पहचानकर्ता — एक मुक्त-रूप स्ट्रिंग (UUID नहीं), ठीक वैसे ही मिलान किया गया जैसा भेजा गया था। example: company-123 responses: '200': description: मेटाडेटा और एकत्रित सत्र डेटा सहित पूर्ण व्यवसाय विवरण। content: application/json: schema: $ref: '#/components/schemas/BusinessDetailItem' examples: Active business: value: didit_internal_id: a1b2c3d4-e5f6-4890-abcd-ef1234567890 vendor_data: company-123 display_name: null legal_name: Acme Trading Ltd registration_number: '12345678' country_code: GB effective_name: Acme Trading Ltd status: ACTIVE session_count: 2 approved_count: 1 declined_count: 0 in_review_count: 1 features: KYB: Approved features_list: - feature: KYB status: Approved last_session_at: '2026-03-15T10:30:00Z' last_activity_at: '2026-03-15T10:30:00Z' first_session_at: '2026-01-10T08:00:00Z' tags: - uuid: 9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d name: VIP color: '#2567FF' created_at: '2026-01-10T08:00:00Z' metadata: industry: fintech updated_at: '2026-03-15T10:30:00Z' '403': description: >- अनुपलब्ध, अमान्य या निरस्त API कुंजी, या यह कुंजी इस एप्लिकेशन के व्यवसायों को नहीं पढ़ सकती है। अनुपलब्ध कुंजी पर `403` मिलता है; गलत, निरस्त या समय-सीमा समाप्त कुंजी पर `401` मिलता है। content: application/json: examples: Forbidden: value: detail: You do not have permission to perform this action. '404': description: >- इस एप्लिकेशन के लिए दिए गए `vendor_data` वाला कोई (हटाया न गया) व्यवसाय मौजूद नहीं है। content: application/json: examples: Not found: value: detail: Not found. '429': description: >- रेट लिमिट पार हो गई; थोड़ा रुकें और `Retry-After` में बताए गए अंतराल के बाद पुनः प्रयास करें। content: application/json: examples: Rate limited: value: detail: Request was throttled. Expected available in 30 seconds. security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: >- curl -X GET 'https://verification.didit.me/v3/businesses/company-123/' \ -H 'x-api-key: YOUR_API_KEY' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.businesses.retrieve( "company-123", ) 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.businesses.retrieve("company-123"); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.Businesses.Retrieve(ctx, \"company-123\")\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: |- import me.didit.Didit; // Reads DIDIT_API_KEY. Didit client = new Didit(); var result = client.businesses().retrieve("company-123"); System.out.println(result); - lang: php label: PHP source: |- businesses->retrieve('company-123'); print_r($result->toArray()); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.businesses.retrieve("company-123") 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.Businesses.RetrieveAsync("company-123"); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: BusinessDetailItem: type: object description: >- पूर्ण व्यवसाय विवरण। मेटाडेटा और updated_at के साथ BusinessListItem का विस्तार करता है। allOf: - $ref: '#/components/schemas/BusinessListItem' - type: object properties: metadata: type: object description: >- कस्टम मेटाडेटा JSON जिसे आपने इस व्यवसाय से जोड़ा है। डिफ़ॉल्ट `{}` है। updated_at: type: string format: date-time BusinessListItem: type: object description: एक सत्यापित व्यवसाय। properties: didit_internal_id: type: string format: uuid description: इस व्यवसाय के लिए Didit का स्थायी आंतरिक UUID। vendor_data: type: string nullable: true description: >- इस व्यवसाय के लिए आपका विशिष्ट पहचानकर्ता (सत्र बनाते समय पास किया गया)। जब कोई वेंडर पहचानकर्ता प्रदान नहीं किया गया था, तो यह null हो सकता है। display_name: type: string nullable: true description: आपके द्वारा सेट किया गया कस्टम प्रदर्शन नाम legal_name: type: string nullable: true description: रजिस्ट्री या मैन्युअल प्रविष्टि से आधिकारिक कानूनी नाम registration_number: type: string nullable: true description: कंपनी पंजीकरण या निगमन संख्या country_code: type: string nullable: true description: निगमन का देश (ISO 3166-1 alpha-2, उदा. `GB`, `US`)। effective_name: type: string nullable: true description: 'सर्वोत्तम उपलब्ध नाम: यदि सेट है तो display_name, अन्यथा legal_name' status: type: string enum: - ACTIVE - FLAGGED - BLOCKED description: >- व्यवसाय रिकॉर्ड की लाइफ़साइकिल स्थिति (सत्र स्थिति नहीं)। `ACTIVE` डिफ़ॉल्ट है, `FLAGGED` इसे मैन्युअल ध्यान के लिए चिह्नित करता है, `BLOCKED` इस `vendor_data` के लिए नए सत्रों को रोकता है। session_count: type: integer description: इस व्यवसाय के लिए सत्यापन सत्रों की कुल संख्या approved_count: type: integer description: स्वीकृत सत्रों की संख्या declined_count: type: integer description: अस्वीकृत सत्रों की संख्या in_review_count: type: integer description: समीक्षाधीन सत्रों की संख्या features: type: object description: >- इस व्यवसाय के सभी KYB सत्रों में प्रति-सुविधा एकत्रित स्थिति। वर्तमान में एकमात्र कुंजी `KYB` (रजिस्ट्री कंपनी जाँच स्थिति) है। संभावित मान: `Approved`, `Declined`, `In Review`, `Not Finished`, `Resub Requested`। features_list: type: array items: type: object properties: feature: type: string status: type: string description: >- `features` जैसा ही डेटा, `{feature, status}` ऑब्जेक्ट्स के एक क्रमबद्ध ऐरे के रूप में। last_session_at: type: string format: date-time nullable: true description: सबसे हाल के सत्र का टाइमस्टैम्प first_session_at: type: string format: date-time nullable: true description: पहले सत्र का टाइमस्टैम्प last_activity_at: type: string format: date-time nullable: true description: >- सबसे हाल की गतिविधि का टाइमस्टैम्प (स्थिति परिवर्तन, सत्र अपडेट, आदि) tags: type: array items: type: object properties: uuid: type: string format: uuid name: type: string color: type: string description: इस व्यवसाय को असाइन किए गए टैग created_at: type: string format: date-time 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.