Create a Sumsub access token by network

Creates a Sumsub access token for External Wallet Access Mode users whose URID NFT lives on an external network. UR issues the token only after an on-chain ownership check: walletProvider(tokenId) on the account contract of the requested network must equal the calling partner's id. The token TTL is fixed at 20 minutes server-side.

post

/v1/create-access-token-by-network

Authorizations

X-Api-SignaturestringRequired

Partner Auth: EIP-191 signature by the partner's registered backend key, with X-Api-Deadline and optional X-Api-PublicKey headers. See the Signature and verify guide.

Header parameters

X-Api-SignaturestringRequired

Partner Auth EIP-191 signature over the canonical message plus the deadline.

X-Api-DeadlinestringRequired

Unix timestamp in seconds after which the signature is no longer valid.

X-Api-PublicKeystringRequired

Partner public key used to verify the signature.

Body

tokenIdstringRequired

URID NFT token id.

networkstringRequired

Network or chain identifier, for example 5000 or 11155111.

Responses

200

Business result envelope. code 0 means success; business rejections return HTTP 200 with a non-zero code.

application/json

codeintegerOptional

Business result code. 0 means success; business rejections return HTTP 200 with a non-zero code.

messagestringOptional

Human-readable diagnostic for non-zero codes.

post/v1/create-access-token-by-network

POST /v1/create-access-token-by-network HTTP/1.1
Host: openapi.ur.app
X-Api-Signature: text
X-Api-Deadline: text
X-Api-PublicKey: text
Content-Type: application/json
Accept: */*
Content-Length: 36

{
  "tokenId": "12345",
  "network": "5000"
}

200

Business result envelope. code 0 means success; business rejections return HTTP 200 with a non-zero code.

{
  "code": 0,
  "message": "success",
  "data": {
    "token": "act-abc123xyz..."
  }
}