Account Item
Retrieve an account by ID.
Available to: Traders (own accounts and any they hold an approved trading permission for); organization administrators (any account in their organization)
Environments: Demo, Live
Rate Limit: No endpoint-specific limit
On Live, some organizations restrict administrators from accessing other members’ accounts unless they hold an approved trading permission for that account.
Resolve a single accountId to its account record. Use this endpoint when you have an accountId from another record (an order, a position, a risk status) and need the account it points to.
Common Failure Scenarios
- No account matches the
id, or theidis for an account you can’t access. Both returnHTTP 404with an empty body, notHTTP 401. - The
idparameter is missing or repeated (HTTP 404), or isn’t a whole number (HTTP 400). - The caller’s user type, or the API key’s permissions, can’t read accounts. This returns
HTTP 401with"Access is denied".
Error Messages
Related Endpoints
- Use
accountItemsto resolve several IDs in one call. - Use
accountListto retrieve every account you can access.
Authentication
AuthorizationBearer
Bearer authentication of the form Bearer <token>, where token is your auth token.
Query parameters
id
Response
Account
name
userId
accountType
Customer, Employee, Giveup, House, Omnibus, Wash
clearingHouseId
riskCategoryId
autoLiqProfileId
marginAccountType
Hedger, Speculator
Allowed values:
legalStatus
Corporation, GP, IRA, Individual, Joint, LLC, LLP, LP, PTR, Trust
timestamp
id
restricted
closed
evaluationSize
readonly
ccEmail
futuresDisabled
swapEnabled
ssfRiskDisclosureAcknowledgment
spotMarginEnabled
active