Skip to main content
POST
/
v1
/
sessions
/
{session_id}
/
share
Share Session
curl --request POST \
  --url https://identity.contra.id/v1/sessions/{session_id}/share
B2B KYC sharing — your customer verifies once with you, and a partner platform inherits the result without re-verifying.

​
Request

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
  }'
BodyTypeRequiredDescription
partner_application_idstringyesThe partner’s Contra application UUID.
expires_inintegernoTTL in seconds (default 3600).

​
Response · 200

{
  "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∗∗perimport;theoriginatingtenantearns∗∗0.15** per import; the originating tenant earns **0.15. The end user never re-verifies.