API product catalogSub-Accounts & White-Label Retail KYC

Get sub-account

Sub-Accounts & White-Label Retail KYC

GET

/users/{userId}

Get sub-account

Sandbox availablegetUsers

Returns a single sub-account by its MyStocks subAccountId. Use this to check wallet balance, KYC status, and account state.

Parameters

userIdstringpathRequired

MyStocks sub-account ID (e.g. usr_abc123).

Example: usr_abc123

Headers

AuthorizationstringRequired

Bearer sk_sandbox_<your_key> for sandbox requests.

Response fields

subAccountIdstring

MyStocks internal ID. Use in /users/{userId}/... paths.

Example: "usr_abc123"

userIdstring

Compatible alias of subAccountId. Use subAccountId as the canonical stored identifier.

externalIdstring

Your own user identifier as set at creation.

Example: "usr_8821"

displayNamestring | null

Example: "Alice K."

emailstring | null

Example: "alice@yourapp.com"

kycStatusNONE | PENDING | VERIFIED | REJECTED

VERIFIED required for trading and asset subscriptions. REJECTED remains gated until re-asserted.

kycLevelNONE | BASIC | FULL

BASIC = ID verified. FULL = enhanced due diligence.

kycRejectionCodestring | null

Stable rejection code when kycStatus is REJECTED.

kycRejectionReasonstring | null

Customer-safe remediation guidance when kycStatus is REJECTED.

kycReviewedAtstring | null

Timestamp of the rejection decision.

statusactive | frozen | closed

walletBalancenumber

Current USD wallet balance.

Example: 1250

Response codes

200Sub-account detail.

404Sub-account not found.

Sandbox playground

Read-only sandbox request

userId Required · pathSandbox API keyYour key stays in this page’s memory.

https://mystocks.africa/api/sandbox/v1/partner/users/%7BuserId%7D

Open in API Tester API Reference

Response schema

{
  "type": "object",
  "properties": {
    "subAccountId": {
      "type": "string",
      "example": "usr_abc123",
      "description": "MyStocks internal ID. Use in /users/{userId}/... paths."
    },
    "userId": {
      "type": "string",
      "description": "Compatible alias of subAccountId. Use subAccountId as the canonical stored identifier."
    },
    "externalId": {
      "type": "string",
      "example": "usr_8821",
      "description": "Your own user identifier as set at creation."
    },
    "displayName": {
      "type": [
        "string",
        "null"
      ],
      "example": "Alice K."
    },
    "email": {
      "type": [
        "string",
        "null"
      ],
      "example": "alice@yourapp.com"
    },
    "kycStatus": {
      "type": "string",
      "enum": [
        "NONE",
        "PENDING",
        "VERIFIED",
        "REJECTED"
      ],
      "description": "VERIFIED required for trading and asset subscriptions. REJECTED remains gated until re-asserted."
    },
    "kycLevel": {
      "type": "string",
      "enum": [
        "NONE",
        "BASIC",
        "FULL"
      ],
      "description": "BASIC = ID verified. FULL = enhanced due diligence."
    },
    "kycRejectionCode": {
      "type": [
        "string",
        "null"
      ],
      "description": "Stable rejection code when kycStatus is REJECTED."
    },
    "kycRejectionReason": {
      "type": [
        "string",
        "null"
      ],
      "description": "Customer-safe remediation guidance when kycStatus is REJECTED."
    },
    "kycReviewedAt": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "description": "Timestamp of the rejection decision."
    },
    "status": {
      "type": "string",
      "enum": [
        "active",
        "frozen",
        "closed"
      ]
    },
    "walletBalance": {
      "type": "number",
      "example": 1250,
      "description": "Current USD wallet balance."
    }
  }
}

curl -X GET 'https://mystocks.africa/api/sandbox/v1/partner/users/%7BuserId%7D' \
  -H "Authorization: Bearer $MYSTOCKS_SANDBOX_API_KEY"

DELETE /users/{userId}

PATCH /users/{userId}