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

# ब्राज़ील कंपनी रजिस्ट्री खोज (CNPJ) API

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

Brazil की Receita Federal रजिस्ट्री में CNPJ से किसी ब्राज़ीलियाई कंपनी को खोजता है: कानूनी और व्यापारिक नाम, पंजीकरण स्थिति, स्थापना तिथि, कानूनी प्रकृति, मुख्य गतिविधि और मुख्यालय का राज्य। Didit यह सेवा `POST /v3/database-validation/` के माध्यम से उपलब्ध कराता है, ताकि आप सबमिट किए गए डेटा को अधिकृत स्रोत से सत्यापित कर सकें और सामान्यीकृत मिलान परिणाम प्राप्त कर सकें।

## कवरेज

* **कवरेज:** \~ 100%
* **देश:** Brazil
* **सेवा ID:** `bra_company_registry`
* **डेटा डोमेन:** सरकार
* **श्रेणी:** कंपनी रजिस्ट्री

## इनपुट

| फ़ील्ड | आवश्यक | उदाहरण |
| - | -: | - |
| `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\_registry)

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

उदाहरण: `bra_company_registry`

**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_registry" \
  -F "vendor_data=user-1234" \
  -F "company_registration_number=11222333000181"
```

हर सफल कॉल 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": "BRA",
  "match_type": "full_match",
  "validations": [
    {
      "outcome_code": "MATCH",
      "service_id": "bra_company_registry",
      "service_name": "Brazil - Company Registry Lookup (CNPJ)",
      "source_data": {
        "company_name": "EMPRESA EXEMPLO LTDA",
        "company_status": "ATIVA",
        "company_status_date": "2025-01-10",
        "headquarters_state": "SP",
        "legal_nature": "SOCIEDADE EMPRESARIA LIMITADA",
        "main_activity": "DESENVOLVIMENTO DE PROGRAMAS DE COMPUTADOR SOB ENCOMENDA",
        "main_activity_code": "6201501",
        "registration_date": "2010-03-15",
        "registration_number": "11222333000181",
        "trade_name": "EXEMPLO"
      },
      "validation": {}
    }
  ]
}
```

**`DOCUMENT_NOT_FOUND`**: सबमिट किया गया दस्तावेज़ नंबर रजिस्ट्री के किसी भी रिकॉर्ड से मेल नहीं खाता।

```json 200 OK — DOCUMENT_NOT_FOUND theme={null}
{
  "request_id": "req_01H…",
  "status": "Declined",
  "issuing_state": "BRA",
  "match_type": "no_match",
  "validations": [
    {
      "outcome_code": "DOCUMENT_NOT_FOUND",
      "service_id": "bra_company_registry",
      "service_name": "Brazil - Company Registry Lookup (CNPJ)",
      "source_data": {
        "identification_number": "NO_MATCH"
      },
      "validation": {}
    }
  ]
}
```

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

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

* `company_name`
* `company_status`
* `company_status_date`
* `headquarters_state`
* `identification_number`
* `legal_nature`
* `main_activity`
* `main_activity_code`
* `registration_date`
* `registration_number`
* `trade_name`

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

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

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