> ## 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

> Didit के ज़रिए दक्षिण अफ़्रीका के आधिकारिक डेटाबेस में कंपनी रजिस्ट्री लुकअप। प्रति कॉल $0.75 से, कोई अनुबंध नहीं, कोई न्यूनतम नहीं।

यह CIPC वाणिज्यिक रजिस्टर में पंजीकरण संख्या के आधार पर दक्षिण अफ़्रीकी कंपनी खोजता है। Didit इस सेवा को `POST /v3/database-validation/` के माध्यम से उपलब्ध कराता है, ताकि आप सबमिट किए गए डेटा की आधिकारिक स्रोत से तुलना कर सकें और सामान्यीकृत मिलान परिणाम प्राप्त कर सकें।

## कवरेज

* **कवरेज:** —
* **देश:** दक्षिण अफ़्रीका
* **सेवा ID:** `zaf_company_registry`
* **डेटा डोमेन:** सरकारी
* **श्रेणी:** CompanyRegister

## इनपुट

| फ़ील्ड | आवश्यक | उदाहरण |
| - | -: | - |
| `company_registration_number` | हाँ | `REG-123456` |
| `company_name` | नहीं | `Sample Company LLC` |
| `vendor_data` | नहीं | `user-1234` |

* **आवश्यक इनपुट:** `company_registration_number`
* **वैकल्पिक इनपुट:** `company_name`, `vendor_data`
* **सहमति:** आवश्यक नहीं
* **वर्कफ़्लो में उपलब्धता:** फ़ील्ड मैपिंग के साथ वर्कफ़्लो में उपलब्ध
* **कवरेज:** —
* **कीमत:** प्रति सफल क्वेरी \$0.75

वर्कफ़्लो में `company_registration_number` किसी पहचान दस्तावेज़ पर छपा नहीं होता, इसलिए कोई चरण इसे अकेले तैयार नहीं करता। इसे किसी प्रश्नावली के उत्तर, Document AI एक्सट्रैक्शन फ़ील्ड, या सत्र बनाते समय आपके भेजे गए मान से लें, और डेटाबेस सत्यापन चरण पर इसकी मैपिंग करें। मैपिंग होने तक वर्कफ़्लो एडिटर इस सेवा को निष्क्रिय दिखाता है और लापता इनपुट का नाम बताता है। रन के समय लापता इनपुट का अर्थ है कि किसी भी क्वेरी से पहले जाँच छोड़ दी जाती है, इसलिए जिस डेटाबेस से पूछा ही नहीं जा सका, उसका शुल्क आपसे कभी नहीं लिया जाता।

## बॉडी पैरामीटर

**issuing\_state** `string` *required* (default: ZAF)

इस डेटाबेस सेवा के लिए ISO 3166-1 alpha-3 देश कोड।

उदाहरण: `ZAF`

**services** `string` *required* (default: zaf\_company\_registry)

इस सेवा ID वाला एक ऐरे। सेवा को पिन करने से अनुरोध इसी सटीक डेटाबेस तक सीमित रहता है।

उदाहरण: `zaf_company_registry`

**company\_registration\_number** `string` *required* (default: REG-123456)

इस डेटाबेस सेवा के लिए आवश्यक `company_registration_number` मान।

उदाहरण: `REG-123456`

**company\_name** `string`

इस डेटाबेस सेवा के लिए आवश्यक `company_name` मान।

उदाहरण: `Sample Company LLC`

**vendor\_data** `string` (default: user-1234)

इस व्यक्ति के लिए आपका स्थिर उपयोगकर्ता संदर्भ, जैसे आपका आंतरिक उपयोगकर्ता ID। Didit इसका उपयोग स्टैंडअलोन जाँचों को उसी अंतिम उपयोगकर्ता से जोड़ने और डुप्लीकेट पहचान के शोर को कम करने के लिए करता है।

उदाहरण: `user-1234`

## इनपुट नियम और सत्यापन नोट्स

* ऊपर सूचीबद्ध फ़ील्ड को ठीक वैसे ही भेजें जैसे वे उपयोगकर्ता या दस्तावेज़ से लिए गए हैं।
* Didit डेटाबेस को कॉल करने से पहले आवश्यक फ़ील्ड की जाँच करता है। स्रोत लुकअप से पहले अस्वीकार किए गए अनुरोधों का शुल्क नहीं लिया जाता।

## इसे कैसे कॉल करें

```bash cURL theme={null}
curl -X POST "https://verification.didit.me/v3/database-validation/" \
  -H "x-api-key: YOUR_API_KEY" \
  -F "issuing_state=ZAF" \
  -F "services=zaf_company_registry" \
  -F "vendor_data=user-1234" \
  -F "company_registration_number=REG-123456"
```

हर सफल कॉल HTTP `200` लौटाती है। **`outcome_code`** फ़ील्ड बताता है कि वास्तव में क्या हुआ, उदाहरण के लिए असली बायोमेट्रिक असंगति (`BIOMETRIC_NO_MATCH`) और ऐसी सेल्फ़ी जिसे पढ़ा नहीं जा सका (`BIOMETRIC_IMAGE_UNUSABLE`) में अंतर। दिखाया गया `status` डिफ़ॉल्ट फ़ीचर स्थिति है; आपकी कॉन्फ़िगर की गई [Partial Match / No Match कार्रवाइयाँ](https://docs.didit.me/hi/core-technology/database-validation/database-validation-warnings.md) इसे बदल सकती हैं।

**`MATCH`**: रजिस्ट्री ने पहचान की पुष्टि की और जाँची गई हर फ़ील्ड मेल खाई।

```json 200 OK — MATCH theme={null}
{
  "request_id": "req_01H…",
  "status": "Approved",
  "issuing_state": "ZAF",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "zaf_company_registry",
      "service_name": "South Africa - Company Registry Lookup",
      "source_data": {},
      "validation": {
        "identification_number": "full_match"
      }
    }
  ]
}
```

**`NO_MATCH`**: सबमिट किए गए डेटा के लिए रजिस्ट्री से कोई मिलान नहीं मिला।

```json 200 OK — NO_MATCH theme={null}
{
  "request_id": "req_01H…",
  "status": "Declined",
  "issuing_state": "ZAF",
  "match_type": "no_match",
  "validations": [
    {
      "outcome_code": "NO_MATCH",
      "service_id": "zaf_company_registry",
      "service_name": "South Africa - Company Registry Lookup",
      "source_data": {
        "identification_number": "NO_MATCH"
      },
      "validation": {
        "identification_number": "no_match"
      }
    }
  ]
}
```

## लौटाया गया डेटा

`source_data` में कौन से सटीक फ़ील्ड दिखेंगे, यह इस पर निर्भर है कि रजिस्ट्री क्या लौटाती है। `zaf_company_registry` के लिए बनाया गया उदाहरण फ़िलहाल इस सामान्यीकृत संरचना का दस्तावेज़ीकरण करता है:

* रजिस्ट्री रिस्पॉन्स के अनुसार अलग-अलग।

## मूल्य निर्धारण और SLA

दक्षिण अफ़्रीका - कंपनी रजिस्ट्री लुकअप क्वेरी का शुल्क केवल तभी लिया जाता है जब Didit को सत्यापन स्रोत से निर्णायक परिणाम मिलता है।

* **प्रति कॉल कीमत:** \$0.75 USD।
* **बिलिंग:** प्रति सफल क्वेरी। जब रजिस्ट्री तक पहुँचा न जा सके, जब आवश्यक फ़ील्ड गायब हों, या जब अनुरोध स्रोत तक पहुँचने से पहले अस्वीकार हो जाए, तब आपसे शुल्क नहीं लिया जाता।
* **लेटेंसी:** सामान्य p95 2 सेकंड से कम।
* **उपलब्धता:** Didit की ओर से प्रति तिमाही 99.9%; डाउनस्ट्रीम स्रोत की उपलब्धता देश और डेटासेट के अनुसार अलग-अलग होती है।

## आगे पढ़ें

* [दक्षिण अफ़्रीका डेटाबेस सत्यापन अवलोकन](https://docs.didit.me/api-reference/database-validation/south-africa.md)
* [डेटाबेस सत्यापन अवलोकन](https://docs.didit.me/hi/core-technology/database-validation/overview.md)
* [परिणाम कोड](https://docs.didit.me/hi/core-technology/database-validation/database-validation-outcome-codes.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.