v1

latestOpenAPI 3.1.02026-07-241653251.3 MB

Customer Accounts (MTA)

Get account details

Retrieves customer account details

get/accounts/{zrn}/details

Path parameters

zrnstring required

Get customer account by account zrn, assigned to the account at creation by zerohash. Format: zrn:zh:eu:account:customer:<uuid>.

Headers

X-SCX-SIGNEDstring required

HMAC-SHA256 signature of the request, base64-encoded. See the Authentication guide for the exact signing formula.

X-SCX-TIMESTAMPstring required

Example:1678901234

Current Unix timestamp in seconds. Must be within 60 seconds of server time or the request is rejected.

Response

Successfully retrieved customer account details.

Example response

{
  "message": {
    "zrn": "zrn:zh:us:accounts:customer:c761fc96-5c44-40d4-8eb2-3fcd5d06754b",
    "participant_code": "PAR001",
    "platform_code": "PLAT01",
    "account_label": "custom-account-label",
    "account_group": "XYZ456",
    "type": "individual",
    "tier": "pro",
    "status": "open",
    "tenants": [
      "PAR002"
    ],
    "financial_advisors": [
      "PAR003"
    ]
  }
}