Skip to main content
POST
/
v0
/
kyc
/
sumsub
/
connect
/
share-token
Generate a KYC share token for partner access
curl --request POST \
  --url https://api.sumvin.com/v0/kyc/sumsub/connect/share-token \
  --header 'Content-Type: application/json' \
  --data '
{
  "for_client_id": "<string>",
  "ttl": 1800,
  "type": "standard"
}
'
{
  "_links": {},
  "token": "<string>",
  "for_client_id": "<string>",
  "expires_in": 123
}

Headers

x-juno-orgid
string | null

Tenant org ID for multi-tenant auth

x-sumvin-token
string | null
x-juno-jwt
string | null

Body

application/json
for_client_id
string
required

SumSub client ID of the partner to share KYC with.

ttl
integer
default:1800

Token TTL in seconds (1 min to 24 hours).

Required range: 60 <= x <= 86400
type
enum<string>
default:standard

Token type: 'standard' uses applicant_id, 'connect' uses OIDC access token.

Available options:
standard,
connect

Response

Share token generated

HAL-style hypermedia links for navigation and available actions.

token
string
required

Share token for partner KYC data access.

for_client_id
string
required

SumSub client ID this token grants access to.

expires_in
integer
required

Token validity in seconds.