Skip to main content
POST
/
v1
/
sessions
/
import-shared
Import Shared Session
curl --request POST \
  --url https://identity.contra.id/v1/sessions/import-shared
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"
  }'
BodyTypeRequiredDescription
share_tokenstringyesToken from the originating tenant.
trust_reviewbooleanyestrue → keep the original status; false → set to in_review.
workflow_idstringyesYour workflow id.
vendor_datastringnoYour own user identifier.

​
Response · 201

{
  "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.