> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecontra.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Share Session

> Mint a one-time share token so a partner platform can import this completed verification.

B2B KYC sharing — your customer verifies once with you, and a partner platform inherits the result without re-verifying.

## Request

```bash theme={null}
curl -X POST https://identity.contra.id/v1/sessions/$SID/share \
  -H "x-api-key: $CONTRA_KEY" -H "Content-Type: application/json" \
  -d '{
    "partner_application_id": "app_partner_…",
    "expires_in":             3600
  }'
```

| Body                     | Type    | Required | Description                            |
| ------------------------ | ------- | -------- | -------------------------------------- |
| `partner_application_id` | string  | **yes**  | The partner's Contra application UUID. |
| `expires_in`             | integer | no       | TTL in seconds *(default 3600)*.       |

## Response · 200

```json theme={null}
{
  "share_token": "shr_a1b2c3d4…",
  "expires_at":  1748570400
}
```

Only sessions in a **terminal** state (`approved`, `declined`, `in_review`) can be shared. Each share token is one-shot per partner.

## Pricing

Contra earns **$0.15** per import; the originating tenant earns **$0.15**. The end user never re-verifies.