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

# ब्राज़ील - कंपनी भागीदार और निदेशक (QSA) API

> Didit के माध्यम से ब्राज़ील कंपनी भागीदार और निदेशक (QSA) का आधिकारिक डेटाबेस लुकअप। प्रति कॉल $0.20 से, कोई कॉन्ट्रैक्ट या न्यूनतम सीमा नहीं।

यह ब्राज़ील की किसी कंपनी के वर्तमान भागीदार और निदेशक (QSA) को उनकी भूमिका और शुरुआत की तिथि के साथ Receita Federal रजिस्टर से लौटाती है। व्यक्तियों के CPF को उसी तरह मास्क किया जाता है जैसे Receita Federal उन्हें प्रकाशित करता है। Didit यह सेवा `POST /v3/database-validation/` के जरिए देता है, ताकि आप जमा किए गए डेटा की जाँच प्रामाणिक स्रोत से कर सकें और सामान्यीकृत मिलान परिणाम पा सकें।

## कवरेज

* **कवरेज:** \~ 100%
* **देश:** ब्राज़ील
* **सेवा ID:** `bra_company_directors`
* **डेटा डोमेन:** सरकारी
* **श्रेणी:** CompanyRegister

## इनपुट

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

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

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

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

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

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

उदाहरण: `BRA`

**services** `string` *required* (default: bra\_company\_directors)

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

उदाहरण: `bra_company_directors`

**company\_registration\_number** `string` *required* (default: 11222333000181)

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

उदाहरण: `11222333000181`

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

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

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

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

* `company_registration_number` को `[0-9A-Za-z]{2}\.?[0-9A-Za-z]{3}\.?[0-9A-Za-z]{3}/?[0-9A-Za-z]{4}-?\d{2}` से मेल खाना चाहिए।

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

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

हर सफल कॉल 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": "BRA",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "bra_company_directors",
      "service_name": "Brazil - Company Partners and Directors (QSA)",
      "source_data": {
        "directors": [
          {
            "document_number": "***.456.789-**",
            "entity_type": "person",
            "name": "MARIA EXEMPLO DA SILVA",
            "role": "SOCIO-ADMINISTRADOR",
            "start_date": "2010-03-15"
          },
          {
            "document_number": "11444777000161",
            "entity_type": "company",
            "name": "HOLDING EXEMPLO S A",
            "role": "SOCIO",
            "start_date": "2018-06-01"
          }
        ],
        "registration_number": "11222333000181"
      },
      "validation": {}
    }
  ]
}
```

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

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

* `directors`
* `registration_number`

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

ब्राज़ील - कंपनी भागीदार और निदेशक (QSA) क्वेरी का शुल्क तभी लिया जाता है जब Didit को सत्यापन स्रोत से निर्णायक परिणाम मिले।

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

## आगे पढ़ें

* [ब्राज़ील डेटाबेस सत्यापन का अवलोकन](https://docs.didit.me/api-reference/database-validation/brazil.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.