> ## 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_directors`
* **डेटा डोमेन:** सरकार
* **श्रेणी:** CompanyRegister

## इनपुट

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

* **आवश्यक इनपुट:** `company_registration_number`
* **वैकल्पिक इनपुट:** `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\_directors)

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

उदाहरण: `zaf_company_directors`

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

इस डेटाबेस सेवा द्वारा आवश्यक `company_registration_number` मान।

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

**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_directors" \
  -F "vendor_data=user-1234" \
  -F "company_registration_number=REG-123456"
```

हर सफल कॉल HTTP `200` लौटाती है। **`outcome_code`** फ़ील्ड बताता है कि वास्तव में क्या हुआ और इनमें अंतर करता है, जैसे कि वास्तविक बायोमेट्रिक मिलान न होना (`BIOMETRIC_NO_MATCH`) और ऐसी सेल्फ़ी जिसे पढ़ा नहीं जा सका (`BIOMETRIC_IMAGE_UNUSABLE`)। दिखाया गया `status` डिफ़ॉल्ट सुविधा स्थिति है; आपकी कॉन्फ़िगर की गई [आंशिक मिलान / कोई मिलान नहीं कार्रवाइयाँ](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_directors",
      "service_name": "South Africa - Company Directors 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_directors",
      "service_name": "South Africa - Company Directors Lookup",
      "source_data": {
        "identification_number": "NO_MATCH"
      },
      "validation": {
        "identification_number": "no_match"
      }
    }
  ]
}
```

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

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

* रजिस्ट्री के उत्तर के अनुसार अलग-अलग होते हैं।

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

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

* **प्रति कॉल कीमत:** \$0.75 USD।
* **बिलिंग:** प्रति सफल क्वेरी। जब रजिस्ट्री तक पहुँचा नहीं जा सकता, जब आवश्यक फ़ील्ड गायब हों, या जब अनुरोध स्रोत तक पहुँचने से पहले अस्वीकार हो जाए, तब आपसे शुल्क नहीं लिया जाता।
* **विलंबता:** सामान्य p95 2 s से कम।
* **उपलब्धता:** 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.