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

# Import Shared Session

> Redeem a share token to clone a partner's verification into your application.

```bash theme={null}
curl -X POST https://identity.contra.id/v1/sessions/import-shared \
  -H "x-api-key: $CONTRA_KEY" -H "Content-Type: application/json" \
  -d '{
    "share_token":  "shr_a1b2c3d4…",
    "trust_review": true,
    "workflow_id":  "enhanced_kyc",
    "vendor_data":  "user-abc-123"
  }'
```

| Body           | Type    | Required | Description                                                      |
| -------------- | ------- | -------- | ---------------------------------------------------------------- |
| `share_token`  | string  | **yes**  | Token from the originating tenant.                               |
| `trust_review` | boolean | **yes**  | `true` → keep the original status; `false` → set to `in_review`. |
| `workflow_id`  | string  | **yes**  | Your workflow id.                                                |
| `vendor_data`  | string  | no       | Your own user identifier.                                        |

## Response · 201

```json theme={null}
{
  "session_id":         "sess_a8f2…",
  "imported_from":      "shr_a1b2c3d4…",
  "status":             "approved",
  "compliance_level":   "enhanced",
  "contra_token":       "eyJ…"
}
```

A share token can only be imported **once per partner application**.