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

# व्यवसाय इंपोर्ट और एक्सपोर्ट: CSV बल्क

> Didit Business Console से CSV द्वारा व्यवसाय (KYB) इकाइयाँ बल्क में लोड करें और पूरी व्यवसाय तालिका एक्सपोर्ट करें। प्रति कॉल बिलिंग।



व्यवसायों के बल्क इंपोर्ट / एक्सपोर्ट का प्रॉम्प्ट
        प्रॉम्प्ट को क्लिपबोर्ड पर कॉपी करें



      
      

\<pre>

\````# Goal — bulk-load (or extract) Didit Business entities programmatically

CSV import / export is console-only. For programmatic bulk operations, loop `POST /v3/businesses/create/` for imports and paginate `GET /v3/businesses/` for exports.

\## Bulk import — loop the create endpoint

\```bash
\# businesses.json — array of records
\# [{"vendor_data":"biz-acme","display_name":"Acme Corp","country_code":"GBR"}, ...]

jq -c '.[]' businesses.json | while read biz; do
curl -X POST https://verification.didit.me/v3/businesses/create/ \
-H "x-api-key: $DIDIT_API_KEY" \
-H "Content-Type: application/json" \
-d "$biz"
sleep 0.1   # respect rate limits — see /integration/rate-limiting
done
\```

Record shape (matches `POST /v3/businesses/create/`):

\```json
\{
"vendor_data": "biz-acme",         // required, unique per app
"display_name": "Acme Corp",       // optional
"country_code": "GBR",             // ISO 3166-1 alpha-3, optional
"metadata": {"partner": "Acme Holdings"},
"tags": ["b2b-tier-1"]
}
\```

\`create` is **not** idempotent. Upsert pattern:

\```bash
if curl -s -o /dev/null -w "%{http_code}" \
 https://verification.didit.me/v3/businesses/$VD/ \
 -H "x-api-key: $DIDIT_API_KEY" | grep -q 200; then
curl -X PATCH https://verification.didit.me/v3/businesses/$VD/ \
-H "x-api-key: $DIDIT_API_KEY" -H "Content-Type: application/json" \
-d "$BODY"
else
curl -X POST https://verification.didit.me/v3/businesses/create/ \
-H "x-api-key: $DIDIT_API_KEY" -H "Content-Type: application/json" \
-d "$BODY"
fi
\```

\## Bulk export — paginate the list endpoint

\```bash
PAGE=1
while :; do
RESP=$(curl -sG https://verification.didit.me/v3/businesses/ \
-H "x-api-key: $DIDIT_API_KEY" \
\--data-urlencode "page=$PAGE" \
\--data-urlencode "page_size=100")
echo "$RESP" | jq -c '.results[]' >> businesses.ndjson
HAS_NEXT=$(echo "$RESP" | jq -r '.next // empty')
\[ -z "$HAS_NEXT" ] && break
PAGE=$((PAGE+1))
done
\```

Filter with `status`, `country_code`, `search`, date ranges (see /management-api/businesses/list).

\## What survives on update vs what stays

\| Field | Behaviour |
\|---|---|
\| `display_name`, `metadata`, `tags` | Overwritten by PATCH |
\| `legal_name`, `registration_number`, `country_code` | Read-only after a verified KYB session (overrides logged in audit log) |
\| Aggregate counters, `features` map | Computed by Didit — never accept writes |

\## Failure modes

\- `409` on create — `vendor_data` exists; use PATCH.
\- `429` — rate limit; back off using `Retry-After`. Insert 100ms+ between calls for large batches.
\- `400` — bad country code or bad JSON. Log and continue.

\## Console fallback

The Business Console (Businesses → Import / Export) handles up to 100K rows for imports and 1M rows for exports with chunked async processing and an emailed signed download link.

\## Sources of truth

\- /management-api/businesses/create — POST /v3/businesses/create/ schema
\- /management-api/businesses/list — GET /v3/businesses/ pagination
\- /entities/businesses/data-model — mutable vs read-only fields
\- /integration/rate-limiting — rate limits
\- /integration/integration-prompt — canonical end-to-end prompt````

\</pre>



      
      

यहाँ पेस्ट करें

Business Console व्यवसाय इकाइयों के बल्क इंपोर्ट और एक्सपोर्ट को सपोर्ट करता है। यह वही प्रवाह है जो उपयोगकर्ताओं के लिए उपलब्ध है, जिसे व्यवसाय के फ़ील्ड के लिए अनुकूलित किया गया है।> [!NOTE]
>
> यहाँ बल्क इंपोर्ट/एक्सपोर्ट केवल व्यवसाय प्रोफ़ाइल बनाता या अपडेट करता है। यह ऐतिहासिक KYB सत्र, रजिस्ट्री रिपोर्ट, अधिकारी, वास्तविक स्वामी या प्रदाता के निर्णयों को दोबारा नहीं बनाता। किसी दूसरे प्रदाता या रजिस्ट्री के एक्सपोर्ट से पूरा KYB माइग्रेशन करने के लिए, [Import Data from Another Provider](https://docs.didit.me/hi/sessions-api/import-verifications.md) देखें।## CSV से व्यवसाय इंपोर्ट करें### इसका उपयोग कब करें- किसी दूसरे KYB विक्रेता से **माइग्रेशन**।
- **पार्टनर ऑनबोर्डिंग**: पार्टनर की ग्राहक सूची लोड करना।
- **मेटाडेटा बैकफ़िल**: कई व्यवसायों के टैग, स्तर या कस्टम फ़ील्ड अपडेट करना।### टेम्पलेट कॉलम*Businesses → Import → Download template* से टेम्पलेट डाउनलोड करें:| कॉलम | आवश्यक | विवरण |
| - | - | - |
| `vendor_data` | हाँ | व्यवसाय के लिए आपका पहचानकर्ता। हर एप्लिकेशन में यूनिक होता है। |
| `display_name` | नहीं | पढ़ने योग्य नाम। |
| `legal_name` | नहीं | कानूनी कंपनी का नाम। सत्यापित रजिस्ट्री डेटा से यह ओवरराइट हो जाएगा। |
| `registration_number` | नहीं | कंपनी का पंजीकरण। सत्यापित रजिस्ट्री डेटा से यह ओवरराइट हो जाएगा। |
| `country_code` | नहीं | ISO 3166-1 alpha-3। खतरनाक देशों की जाँच शुरू करता है। |
| `status` | नहीं | `ACTIVE`, `FLAGGED`, या `BLOCKED`। डिफ़ॉल्ट `ACTIVE` है। |
| `tags` | नहीं | कॉमा से अलग किए गए टैग। |
| `metadata_json` | नहीं | कस्टम मेटाडेटा के लिए स्ट्रिंग में बदला हुआ JSON। |### इंपोर्ट चलाना**1. CSV अपलोड करें***Businesses → Import → Upload CSV*।**2. प्रीव्यू की समीक्षा करें**अमान्य पंक्तियाँ हाइलाइट की जाती हैं। डुप्लिकेट (मौजूदा `vendor_data`) को अपडेट के रूप में चिह्नित किया जाता है।**3. इंपोर्ट शुरू करें**Didit पंक्तियों को एसिंक्रोनस रूप से प्रोसेस करता है; प्रगति *Businesses → Import history* में ट्रैक होती है।**4. नतीजों की समीक्षा करें**छोड़ी गई किसी भी पंक्ति के लिए एरर रिपोर्ट डाउनलोड करें।### अपडेट बनाम बनाना- नया `vendor_data` → एक नया व्यवसाय बनाता है।
- मौजूदा `vendor_data` → व्यवसाय के बदले जा सकने वाले फ़ील्ड और मेटाडेटा अपडेट करता है।
- रजिस्ट्री से लिए गए फ़ील्ड (`legal_name`, `registration_number`, `country_code`) को इंपोर्ट द्वारा **नहीं** ओवरराइट किया जाता, जब एक व्यवसाय सत्यापन (KYB) सत्र उन्हें भर चुका हो।## व्यवसायों को CSV में एक्सपोर्ट करें### इसका उपयोग कब करें- **अनुपालन ऑडिट** और नियामक के अनुरोध।
- BI के लिए **डेटा वेयरहाउस सिंक**।
- **पार्टनर रिपोर्टिंग**: देश, स्तर या टैग के अनुसार फ़िल्टर किए गए व्यवसायों के दृश्य।### एक्सपोर्ट चलाना1) *Businesses → Export* पर जाएँ।
2) फ़िल्टर लागू करें (स्थिति, देश, तिथि सीमा, खोज, टैग)।
3) कॉलम चुनें।
4) सबमिट करें: Didit एक्सपोर्ट एसिंक्रोनस रूप से बनाता है और एक साइन किया हुआ डाउनलोड लिंक ईमेल करता है।भूमिका संबंधी प्रतिबंध लागू होते हैं। देखें [roles & permissions](https://docs.didit.me/hi/console/roles-permissions.md)।## ऑडिट ट्रेलसभी इंपोर्ट और एक्सपोर्ट ऑपरेटर, पंक्तियों की संख्या और टाइमस्टैम्प के साथ लॉग किए जाते हैं। देखें [audit logs](https://docs.didit.me/hi/console/audit-logs.md)।## अगले कदम> [card] [व्यवसाय API बनाएँ](https://docs.didit.me/hi/management-api/businesses/create.md)
>
> प्रोग्रामेटिक बल्क निर्माण।> [card] [डेटा प्रतिधारण](https://docs.didit.me/hi/console/data-retention.md)
>
> इंपोर्ट किया गया डेटा कितने समय तक रहता है।> [card] [ऑडिट लॉग](https://docs.didit.me/hi/console/audit-logs.md)
>
> इंपोर्ट/एक्सपोर्ट का इतिहास देखें।


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