Get Account Trading Permissions
Query the granted trading permissions associated with this account.
Available to: Traders (own account); organization administrators (any account in their organization)
Environments: Demo, Live
Rate Limit: 100 requests per hour, 1-second back-off, counts all requests
Retrieve every trading permission on the account identified by accountId. Each TradingPermission ties a user to the account and carries the permission’s status, so this endpoint shows which users can trade the account and where each one stands in the approval flow.
Don’t poll this endpoint to watch for a permission’s approval. The rate limit counts every request, so a polling loop pushes you toward a penalty ticket. After you call createTradingPermission, keep the permission ID it returns and fetch that record directly by its ID, or subscribe to updates over a WebSocket with user/syncRequest. See Penalty Tickets.
Common Failure Scenarios
- A Trader queries an account they don’t own. The call is denied.
- The
accountIdcan’t be reached: it doesn’t exist, or it’s in another organization (organization administrators can only query accounts in their own organization). The call fails with a not-found error.
Related Endpoints
- Use
createTradingPermissionto grant a permission to a user in one step. - Use
requestTradingPermissionto request a permission the account holder then accepts withacceptTradingPermission. - Use
revokeTradingPermissionorrevokeTradingPermissionsto remove permissions.
Authentication
Bearer authentication of the form Bearer <token>, where token is your auth token.