> ## 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. # Token di condivisione API: Share Session > Didit: POST /v3/session/{id}/share/ genera un token di condivisione a tempo per KYC o KYB riutilizzabile. JWT firmato, pay-per-call, senza contratti. Prompt per condividere la sessione Copia il prompt negli appunti \

\`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.`

\
Incolla in ## Supporto per KYC e KYBFunziona sia per le sessioni **Verifica degli utenti (KYC)** sia per le sessioni **Verifica aziendale (KYB)**. Didit cerca il `session_id` in entrambi i tipi di sessione e genera un token di condivisione JWT che include:```json theme={null} { "session_id": "...", "session_kind": "user" | "business", "from_application_id": "...", "for_application_id": "...", "iat": ..., "exp": ... } ```Quando il partner destinatario importa il token, Didit clona il tipo di sessione corrispondente (KYC o KYB) con le relative relazioni.## Requisiti- La sessione deve trovarsi in uno stato **concluso** (`APPROVED`, `DECLINED`, `IN_REVIEW`). - Devi disporre del privilegio `write:sessions`. - Il `for_application_id` deve essere un'applicazione Didit valida (di solito l'applicazione di un partner).## Esempi> [tab] Condividi una sessione di Verifica degli utenti (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 > }' > ``` > > **Risposta:** > > ```json theme={null} > { > "share_token": "eyJhbGciOiJIUzI1NiJ9...", > "for_application_id": "partner-app-uuid", > "session_kind": "user" > } > ```> [tab] Condividi una sessione di Verifica aziendale (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 > }' > ``` > > **Risposta:** > > ```json theme={null} > { > "share_token": "eyJhbGciOiJIUzI1NiJ9...", > "for_application_id": "partner-app-uuid", > "session_kind": "business" > } > ```## Limiti del TTL| Parametro | Min | Max | Predefinito | | - | - | - | - | | `ttl_in_seconds` | 60 | 86400 | 3600 |## Contenuti correlati- [Importa sessione condivisa](https://docs.didit.me/it/sessions-api/share-session/import.md) - [Guida KYC riutilizzabile](https://docs.didit.me/it/core-technology/reusable-kyc/share-kyc-via-api.md) - [Panoramica delle sessioni](https://docs.didit.me/it/sessions-api/overview.md) ## OpenAPI ````yaml it/openapi-25.json POST /v3/session/{sessionId}/share/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API di verifica dell'identità. Autenticati con l'intestazione x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/session/{sessionId}/share/: post: tags: - Sessions summary: Genera un token di condivisione per una sessione di verifica completata description: >- Genera un JWT di breve durata che consente a una specifica applicazione Didit di importare questa sessione completata. Da associare a `POST /v3/session/import-shared/`. operationId: post_v3_session_share parameters: - in: path name: sessionId required: true description: >- UUID della sessione di verifica di origine per cui generare un token. 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: >- UUID dell'applicazione Didit che riscatterà il token. Deve esistere, non deve essere eliminata e deve essere diversa dall'applicazione chiamante. Puoi trovarlo nella Business Console sotto **Settings → Application**. example: a5f3bca2-46e2-411e-90ef-a580900a57ee ttl_in_seconds: type: integer description: >- Durata del token, in secondi. Minimo `60`, massimo `86400` (24 ore). Il valore predefinito è `3600` (1 ora). 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 di condivisione generato. content: application/json: schema: type: object properties: share_token: type: string description: >- JWT firmato con HS256. Passalo così com'è come `share_token` a [`POST /v3/session/import-shared/`](/sessions-api/import-shared-session) sull'applicazione di destinazione. example: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... for_application_id: type: string format: uuid description: >- Restituisce l'UUID dell'applicazione di destinazione a cui è associato il token. example: a5f3bca2-46e2-411e-90ef-a580900a57ee session_kind: type: string enum: - user - business description: >- Indica se la sessione di origine è una sessione di Verifica degli utenti (KYC) o di Verifica aziendale (KYB). examples: User session: summary: Condividi una sessione KYC value: share_token: >- eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzZXNzaW9uX2lkIjoiMjBiYjNjM2ItNjE0Ni00MzlmLTg0YTQtYmQzMGQwMGFjNmEyIiwiZnJvbV9hcHBsaWNhdGlvbl9pZCI6ImRiZDIwZTM0LTQyZTktNGYyYy1iYTkxLWNmMDc2MjAxNmY2NCIsImZvcl9hcHBsaWNhdGlvbl9pZCI6ImE1ZjNiY2EyLTQ2ZTItNDExZS05MGVmLWE1ODA5MDBhNTdlZSIsImlhdCI6MTc1MzYzMDY2NiwiZXhwIjoxNzUzNjM0MjY2fQ.JJ9pNE_hqZsOtbR0XYZIWw4JzidjdEl279iUrsIkhGE for_application_id: a5f3bca2-46e2-411e-90ef-a580900a57ee session_kind: user Business session: summary: Condividi una sessione KYB value: share_token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... for_application_id: a5f3bca2-46e2-411e-90ef-a580900a57ee session_kind: business '400': description: >- Errore di validazione. Gli errori di campo sono indicizzati per nome di campo; l'errore di mancato completamento arriva sotto una chiave `detail` (come array). content: application/json: examples: Wrong status: summary: La sessione di origine non è terminata value: detail: - >- Only finished sessions ("Approved", "Declined", "In Review") can be shared. Target missing: summary: L'applicazione di destinazione non esiste value: for_application_id: - Target application does not exist. Self-share: summary: La destinazione è l'applicazione chiamante value: for_application_id: - Cannot share a session with the same application. TTL bounds: summary: ttl_in_seconds fuori dai limiti value: ttl_in_seconds: - Ensure this value is greater than or equal to 60. '401': description: >- Credenziali mancanti o non valide. A differenza della maggior parte degli endpoint v3, questo endpoint esegue l'autenticazione tramite il decoratore di autorizzazione e restituisce `401` se non viene presentato un token o una chiave validi. content: application/json: examples: Unauthorized: summary: Non autorizzato value: detail: >- Authentication credentials were not provided or are invalid. '403': description: >- Le credenziali sono valide ma non dispongono dell'autorizzazione `write:sessions` per questa applicazione. content: application/json: examples: No Permission: summary: Nessuna autorizzazione value: detail: You do not have permission to perform this action. '404': description: >- Nessuna sessione con il `session_id` specificato esiste nella tua applicazione. content: application/json: examples: Not Found: summary: Sessione non trovata 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: >- La chiave API della tua applicazione, da Developers -> API keys nella Business Console. La chiave primaria ha accesso completo. Una chiave con nome può avere un ambito definito: nessuno, lettura o scrittura per risorsa, limitata ad alcuni workflow o a sessioni approvate, a un elenco di indirizzi IP e a una data di scadenza. 401 indica che la chiave è errata, revocata o scaduta; 403 indica che non è stata inviata alcuna chiave, che la chiave non ha accesso a questa risorsa o azione, oppure che la richiesta proviene da un indirizzo non incluso nel suo elenco IP; 404 su una route di sessione indica che la sessione non rientra nei workflow o negli stati previsti dalla chiave. Una chiave senza accesso ai media riceve gli URL di immagini, video e PDF come null, e una chiave senza permessi di scrittura sulle sessioni riceve link e token di sessione come null. Consulta https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.