v1

latestOpenAPI 3.1.02026-07-241653251.3 MB

User Token

Initialize session

Create a new session and receive a JWT for authenticated API requests.

post/api/v1/sessions

Headers

x-connect-client-idstring required

Client ID that must match the organization ID in the JWT token

Signaturestring required

Request signature for validation (required for most organizations)

timestampstring required

Timestamp used for signature validation

Request body

request_idstring

Optional request ID. If not provided, a UUID will be generated automatically

scopes'user:deposit:send' | 'user:recovery:send' | 'user:withdrawal:request'

List of scopes for the session

Example request

{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "account": {
    "reference_id": "07NVS8"
  },
  "session": {
    "metadata": {
      "organization_metadata": "test-01-10-001",
      "user_agent": "Mozilla/5.0...",
      "ip_address": "192.168.1.1"
    },
    "withdrawal_details": {
      "asset": "BTC",
      "network": "bitcoin",
      "amount": "0.001",
      "account_label": "Main Account"
    },
    "deposit_details": {
      "account_label": "Main Account"
    }
  }
}

Response

Session created successfully

jwtstring required

JWT token for the created session

expires_ininteger required

Token expiration time in seconds

Example response

{
  "jwt": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expires_in": 3600
}