> ## 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 से POST /v3/session/{id}/share/ द्वारा पुनः प्रयोज्य KYC या KYB के लिए समय-सीमित शेयर टोकन जनरेट करें। JWT-साइन्ड, प्रति कॉल भुगतान, कोई अनुबंध नहीं। सत्र साझा करने का प्रॉम्प्ट प्रॉम्प्ट को क्लिपबोर्ड पर कॉपी करें \

\`Mint a short-lived share token so another Didit application can import this finished verification session (Reusable KYC / KYB).

Endpoint:
POST https://verification.didit.me/v3/session/{session_id}/share/

Authentication:
Use the x-api-key header with your Didit API key. Privilege: write:sessions.

Path parameter:
\- session_id (UUID) — works for both User Verification (KYC) and Business Verification (KYB).

Request body:
\- for_application_id (string, UUID, required) — UUID of the receiving Didit application. Must exist, must not be deleted, and must be different from the calling application.
\- ttl_in_seconds (integer, optional, default 3600) — Lifetime of the share token. Min 60, max 86400 (24 hours).

Prerequisites:
\- Session status must be one of "Approved", "Declined", "In Review". Any other status returns 400 ("Only finished sessions ... can be shared.").

curl example:
curl -X POST https://verification.didit.me/v3/session//share/ \
-H "x-api-key: " \
-H "Content-Type: application/json" \
-d '{
"for_application_id": "",
"ttl_in_seconds": 3600
}'

Response:
\- share_token (string) — HS256-signed JWT with payload { session_id, session_kind, from_application_id, for_application_id, iat, exp }.
\- for_application_id (UUID) — echoed back.
\- session_kind ("user" | "business") — embedded so the receiver clones the right kind.

Token characteristics:
\- Bound to for_application_id — only that application can redeem it via POST /v3/session/import-shared/.
\- Cannot be revoked via API — it simply expires after ttl_in_seconds.
\- You can mint multiple tokens for the same session (e.g. one per partner). Each call returns a fresh JWT with a new iat.

Failure modes:
\- 400 — { "detail": "Only finished sessions ... can be shared." } when the session isn't Approved/Declined/In Review.
\- 400 — { "for_application_id": ["..."] } for unknown or self application UUIDs.
\- 401 — invalid API key.
\- 403 — { "detail": "You do not have permission to perform this action." } when the key lacks write:sessions.
\- 404 — { "detail": "Not found." } when the session_id is not visible to this application.

Send the share_token to the receiving partner through your own secure channel (HTTPS API call, webhook, signed email link, etc.).

Next step:
The receiving application calls POST https://verification.didit.me/v3/session/import-shared/ with the share_token to clone the session — see /sessions-api/share-session/import.

For end-to-end Didit integration, paste in the full prompt at /integration/integration-prompt.`

\
यहाँ पेस्ट करें ## KYC और KYB समर्थनयह **उपयोगकर्ता सत्यापन (KYC)** और **व्यवसाय सत्यापन (KYB)** दोनों सत्रों के लिए काम करता है। Didit दोनों प्रकार के सत्रों में `session_id` को हल करता है और एक JWT शेयर token बनाता है, जिसमें शामिल है:```json theme={null} { "session_id": "...", "session_kind": "user" | "business", "from_application_id": "...", "for_application_id": "...", "iat": ..., "exp": ... } ```जब प्राप्त करने वाला पार्टनर token इंपोर्ट करता है, तब Didit संबंधित प्रकार का सत्र (KYC या KYB) उसके संबंधों सहित क्लोन करता है।## आवश्यकताएँ- सत्र किसी समाप्त स्थिति में होना चाहिए (`APPROVED`, `DECLINED`, `IN_REVIEW`)। - आपके पास `write:sessions` विशेषाधिकार होना चाहिए। - `for_application_id` एक मान्य Didit एप्लिकेशन होना चाहिए (आमतौर पर पार्टनर का एप्लिकेशन)।## उदाहरण> [tab] उपयोगकर्ता सत्यापन (KYC) सत्र साझा करें > > ```bash theme={null} > curl -X POST https://verification.didit.me/v3/session/4c5c7f3a-.../share/ \ > -H "x-api-key: YOUR_API_KEY" \ > -H "Content-Type: application/json" \ > -d '{ > "for_application_id": "partner-app-uuid", > "ttl_in_seconds": 3600 > }' > ``` > > **रिस्पॉन्स:** > > ```json theme={null} > { > "share_token": "eyJhbGciOiJIUzI1NiJ9...", > "for_application_id": "partner-app-uuid", > "session_kind": "user" > } > ```> [tab] व्यवसाय सत्यापन (KYB) सत्र साझा करें > > ```bash theme={null} > curl -X POST https://verification.didit.me/v3/session/bs-01HJX1.../share/ \ > -H "x-api-key: YOUR_API_KEY" \ > -H "Content-Type: application/json" \ > -d '{ > "for_application_id": "partner-app-uuid", > "ttl_in_seconds": 7200 > }' > ``` > > **रिस्पॉन्स:** > > ```json theme={null} > { > "share_token": "eyJhbGciOiJIUzI1NiJ9...", > "for_application_id": "partner-app-uuid", > "session_kind": "business" > } > ```## TTL सीमाएँ| पैरामीटर | न्यूनतम | अधिकतम | डिफ़ॉल्ट | | - | - | - | - | | `ttl_in_seconds` | 60 | 86400 | 3600 |## संबंधित- [साझा सत्र इंपोर्ट करें](https://docs.didit.me/hi/sessions-api/share-session/import.md) - [पुनः प्रयोज्य KYC गाइड](https://docs.didit.me/hi/core-technology/reusable-kyc/share-kyc-via-api.md) - [सत्र अवलोकन](https://docs.didit.me/hi/sessions-api/overview.md) ## OpenAPI ````yaml hi/openapi-25.json POST /v3/session/{sessionId}/share/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: पहचान सत्यापन API। x-api-key हेडर के साथ प्रमाणीकृत करें। servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/session/{sessionId}/share/: post: tags: - Sessions summary: पूर्ण सत्यापन सत्र के लिए एक शेयर token जनरेट करें description: >- एक अल्पकालिक JWT जनरेट करें जो किसी विशिष्ट Didit एप्लिकेशन को इस पूर्ण सत्र को इंपोर्ट करने की अनुमति देता है। `POST /v3/session/import-shared/` के साथ उपयोग करें। operationId: post_v3_session_share parameters: - in: path name: sessionId required: true description: token मिंट करने के लिए स्रोत सत्यापन सत्र का UUID। schema: type: string format: uuid example: 11111111-2222-3333-4444-555555555555 requestBody: required: true content: application/json: schema: type: object required: - for_application_id properties: for_application_id: type: string format: uuid description: >- Didit एप्लिकेशन का UUID जो token को रिडीम करेगा। यह मौजूद होना चाहिए, हटाया हुआ नहीं होना चाहिए, और कॉल करने वाले एप्लिकेशन से भिन्न होना चाहिए। इसे Business Console में **Settings → Application** के अंतर्गत खोजें। example: a5f3bca2-46e2-411e-90ef-a580900a57ee ttl_in_seconds: type: integer description: >- Token का लाइफ़टाइम, सेकंड में। न्यूनतम `60`, अधिकतम `86400` (24 घंटे)। डिफ़ॉल्ट रूप से `3600` (1 घंटा)। minimum: 60 maximum: 86400 default: 3600 example: 3600 example: for_application_id: a5f3bca2-46e2-411e-90ef-a580900a57ee ttl_in_seconds: 7200 responses: '200': description: शेयर token मिंट किया गया। content: application/json: schema: type: object properties: share_token: type: string description: >- HS256-हस्ताक्षरित JWT। इसे टारगेट एप्लिकेशन पर [`POST /v3/session/import-shared/`](/sessions-api/import-shared-session) को `share_token` के रूप में हूबहू पास करें। example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... for_application_id: type: string format: uuid description: >- उस लक्षित एप्लिकेशन UUID का इको करता है जिससे टोकन बाउंड है। example: a5f3bca2-46e2-411e-90ef-a580900a57ee session_kind: type: string enum: - user - business description: >- क्या स्रोत सत्र एक उपयोगकर्ता सत्यापन (KYC) या व्यवसाय सत्यापन (KYB) सत्र है। examples: User session: summary: KYC सत्र साझा करें value: share_token: >- eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzZXNzaW9uX2lkIjoiMjBiYjNjM2ItNjE0Ni00MzlmLTg0YTQtYmQzMGQwMGFjNmEyIiwiZnJvbV9hcHBsaWNhdGlvbl9pZCI6ImRiZDIwZTM0LTQyZTktNGYyYy1iYTkxLWNmMDc2MjAxNmY2NCIsImZvcl9hcHBsaWNhdGlvbl9pZCI6ImE1ZjNiY2EyLTQ2ZTItNDExZS05MGVmLWE1ODA5MDBhNTdlZSIsImlhdCI6MTc1MzYzMDY2NiwiZXhwIjoxNzUzNjM0MjY2fQ.JJ9pNE_hqZsOtbR0XYZIWw4JzidjdEl279iUrsIkhGE for_application_id: a5f3bca2-46e2-411e-90ef-a580900a57ee session_kind: user Business session: summary: KYB सत्र साझा करें value: share_token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... for_application_id: a5f3bca2-46e2-411e-90ef-a580900a57ee session_kind: business '400': description: >- सत्यापन त्रुटि। फ़ील्ड त्रुटियां फ़ील्ड नाम के अनुसार व्यवस्थित होती हैं; पूरा न होने की त्रुटि `detail` key के तहत (एक array के रूप में) आती है। content: application/json: examples: Wrong status: summary: स्रोत सत्र समाप्त नहीं हुआ है value: detail: - >- Only finished sessions ("Approved", "Declined", "In Review") can be shared. Target missing: summary: लक्षित एप्लिकेशन मौजूद नहीं है value: for_application_id: - Target application does not exist. Self-share: summary: टारगेट ही कॉल करने वाला एप्लिकेशन है value: for_application_id: - Cannot share a session with the same application. TTL bounds: summary: ttl_in_seconds सीमाओं से बाहर है value: ttl_in_seconds: - Ensure this value is greater than or equal to 60. '401': description: >- अनुपलब्ध या अमान्य क्रेडेंशियल। अधिकांश v3 endpoints के विपरीत, यह endpoint अनुमति डेकोरेटर के माध्यम से प्रमाणित करता है और कोई मान्य token/कुंजी प्रस्तुत न होने पर `401` लौटाता है। content: application/json: examples: Unauthorized: summary: अनधिकृत value: detail: >- Authentication credentials were not provided or are invalid. '403': description: >- क्रेडेंशियल मान्य हैं लेकिन इस एप्लिकेशन के लिए `write:sessions` अनुमति नहीं है। content: application/json: examples: No Permission: summary: कोई अनुमति नहीं value: detail: You do not have permission to perform this action. '404': description: आपके एप्लिकेशन में दिए गए `session_id` वाला कोई सत्र मौजूद नहीं है। content: application/json: examples: Not Found: summary: सत्र नहीं मिला value: detail: Not found. security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: |- curl -X POST \ https://verification.didit.me/v3/session/11111111-2222-3333-4444-555555555555/share/ \ -H 'x-api-key: YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{ "for_application_id": "a5f3bca2-46e2-411e-90ef-a580900a57ee", "ttl_in_seconds": 7200 }' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.sessions.share( "11111111-2222-3333-4444-555555555555", for_application_id="a5f3bca2-46e2-411e-90ef-a580900a57ee", ttl_in_seconds=7200, ) print(result) - lang: javascript label: Node.js source: >- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); const result = await didit.sessions.share("11111111-2222-3333-4444-555555555555", { for_application_id: "a5f3bca2-46e2-411e-90ef-a580900a57ee", ttl_in_seconds: 7200, }); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.Sessions.Share(ctx, \"11111111-2222-3333-4444-555555555555\", didit.SessionsShareParams{\n\tForApplicationID: \"a5f3bca2-46e2-411e-90ef-a580900a57ee\",\n\tTTLInSeconds: didit.Int(7200),\n})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: >- import me.didit.Didit; import me.didit.types.SessionsShareParams; // Reads DIDIT_API_KEY. Didit client = new Didit(); var result = client.sessions().share("11111111-2222-3333-4444-555555555555", SessionsShareParams.builder() .forApplicationId("a5f3bca2-46e2-411e-90ef-a580900a57ee") .ttlInSeconds(7200L) .build()); System.out.println(result); - lang: php label: PHP source: >- sessions->share('11111111-2222-3333-4444-555555555555', [ 'for_application_id' => 'a5f3bca2-46e2-411e-90ef-a580900a57ee', 'ttl_in_seconds' => 7200, ]); print_r($result->toArray()); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.sessions.share( "11111111-2222-3333-4444-555555555555", for_application_id: "a5f3bca2-46e2-411e-90ef-a580900a57ee", ttl_in_seconds: 7200 ) puts result.to_h - lang: csharp label: .NET source: >- using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); var result = await client.Sessions.ShareAsync("11111111-2222-3333-4444-555555555555", new SessionsShareParams { ForApplicationId = "a5f3bca2-46e2-411e-90ef-a580900a57ee", TtlInSeconds = 7200, }); Console.WriteLine(JsonSerializer.Serialize(result)); components: securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- आपकी एप्लिकेशन की API कुंजी, Business Console में Developers -> API keys से। प्राथमिक कुंजी के पास पूर्ण एक्सेस होता है। एक नामित कुंजी को स्कोप किया जा सकता है: प्रति संसाधन none, read या write, कुछ वर्कफ़्लो या स्वीकृत सत्रों तक सीमित, IP पतों की सूची तक सीमित, और समाप्ति तिथि तक सीमित। 401 का अर्थ है कि कुंजी गलत है, निरस्त कर दी गई है या उसकी समय-सीमा समाप्त हो गई है; 403 का अर्थ है कि कोई कुंजी नहीं भेजी गई थी, कुंजी के पास इस संसाधन या कार्रवाई का एक्सेस नहीं है, या अनुरोध उसकी IP सूची से बाहर के पते से आया था; सत्र रूट पर 404 का अर्थ है कि सत्र कुंजी के वर्कफ़्लो या स्थितियों से बाहर है। मीडिया एक्सेस के बिना एक कुंजी को छवि, वीडियो और PDF URL null के रूप में प्राप्त होते हैं, और सत्र write के बिना एक कुंजी को सत्र लिंक और token null के रूप में प्राप्त होते हैं। देखें https://docs.didit.me/console/api-keys। ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.