> ## Documentation Index > Fetch the complete documentation index at: https://tickblaze.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve trading account information > Returns information for a specific trading account. Account-level auto-liquidation data is unavailable: legacy fields are retained for compatibility and return null, and must not be interpreted as daily drawdown state. ## OpenAPI ````yaml /openapi.json get /api/accounts/{id}/ openapi: 3.0.3 info: title: TBBO API version: 1.0.0 description: > Authentication uses short-lived session tokens (3 hours). Send the token with every request using the `Authorization` header: ``` Authorization: Token ``` Example: ``` Authorization: Token 123abc456def789 ``` To obtain a token, call `POST /auth/login/` with valid credentials. The response includes a `key` value. Use that value in the header above for subsequent API calls. How to find required IDs: - `challenge_id`: Prop Tech Configuration -> Challenges - `user_id`: Tickblaze Manager -> Users - `account_id`: Tickblaze Manager -> Accounts servers: [] security: [] tags: - name: withdrawals description: Withdrawal related endpoints x-displayName: Withdrawals paths: /api/accounts/{id}/: get: tags: - Accounts summary: Retrieve trading account information description: >- Returns information for a specific trading account. Account-level auto-liquidation data is unavailable: legacy fields are retained for compatibility and return null, and must not be interpreted as daily drawdown state. operationId: api_accounts_retrieve parameters: - in: path name: id schema: type: integer description: A unique integer value identifying this account. required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/AccountTickblazeManager' examples: TradingAccountDetailResponse: value: id: 1234 email: trader@example.com account_type: FUNDED user_id: 5678 prop_firm_id: 507ede8b-951d-4c38-877a-f242463ce14f prop_firm_name: Example Firm challenge_title: 2-Step Challenge challenge_short_code: '001122' auto_liquidate_triggered_timestamp: null failure_metadata: null current_balance: 10250.75 previous_end_of_day_balance: 10120.5 closed_pnl_today: 130.25 daily_drawdown_floor: 9750 open_pnl: -45.1 open_positions_count: 3 peak_realized_balance: 10500 lowest_realized_balance: 9800 peak_unrealized_balance: 10420 lowest_unrealized_balance: 9950 account_currency: USD auto_liquidation_eNonebled: null auto_liquidation_enabled: null auto_liquidation_data_status: unavailable auto_liquidation_criteria: null auto_liquidation_triggered: null auto_liquidation_timestamp: null long_positions_count: 2 short_positions_count: 1 net_positions_count: 1 is_trading_allowed: true oms_flags: null last_trade_timestamp: '2026-01-26T18:42:10Z' risk_algorithm: STANDARD drawdown_type: STATIC max_drawdown: 5000 daily_max_drawdown: 2500 minimum_account_balance: 5000 trading_days: 18 consistency_score: 92 created: '2025-11-01T09:30:00Z' modified: '2026-01-26T18:42:10Z' deleted: false is_giveaway: false start_date: '2025-11-01T00:00:00Z' end_date: null source: WEBHOOK initial_balance: 10000 live_account_balance_currency: USD live_account_equity_currency: USD live_account_equity: 10205.65 leverage: '1:100' profit_loss_currency: USD profit_loss: 250.75 broker_type: MatchTrade last_daily_drawdown_amount_currency: USD last_daily_drawdown_amount: 120 last_global_drawdown_amount_currency: USD last_global_drawdown_amount: 320 daily_drawdown_expiry: '2026-01-27T00:00:00Z' status: ACTIVE status_finalised_timestamp: null status_reason: null custom_status_reason: null profit_split: 80 payout_frequency: 30 next_withdrawal_date: '2026-02-15T00:00:00Z' copy_trading_detected: false failed_review_reason: null first_withdrawal_delay: 14 max_position_size_account: 10 order: 1 phase: 2 match_trader_trading_account: 18b9851c-aa72-498b-bee1-c84411975792 metatrader_trading_account: 0 metatrader5_trading_account: 0 tradelocker_trading_account: null sim2funded_trading_account: 0 ctrader_trading_account: 0 tradovate_trading_account: 0 volumetrica_trading_account: null summary: Account information response description: '' '404': description: Account not found. security: - tokenAuth: [] components: schemas: AccountTickblazeManager: type: object properties: id: type: integer readOnly: true email: type: string format: email readOnly: true description: Email address of the account owner. account_type: type: string readOnly: true description: Type of trading account (e.g. challenge, verification, funded). user_id: type: integer readOnly: true description: Unique identifier of the user who owns the trading account. prop_firm_id: type: string format: uuid description: Unique identifier of the proprietary trading firm. prop_firm_name: type: string readOnly: true description: Display name of the proprietary trading firm. challenge_title: type: string readOnly: true nullable: true description: Title of the challenge attached to the account's current phase. challenge_short_code: type: string readOnly: true nullable: true description: >- Short code copied from the challenge attached to the account's current phase. auto_liquidate_triggered_timestamp: type: string readOnly: true nullable: true description: >- Deprecated legacy field. Account-level auto-liquidation data is unavailable; this field always returns null. failure_metadata: readOnly: true description: >- Structured breach or failure context for the account, when available. current_balance: type: string readOnly: true description: Current account balance. current_equity: type: string readOnly: true description: Current account equity, including unrealized profit or loss. previous_end_of_day_balance: type: string readOnly: true description: Account balance at the end of the previous trading day. daily_pnl: type: string format: decimal pattern: ^-?\d{0,26}(?:\.\d{0,2})?$ readOnly: true nullable: true description: Profit or loss for the account during the current trading day. realized_pnl: type: string format: decimal pattern: ^-?\d{0,26}(?:\.\d{0,2})?$ readOnly: true nullable: true description: Realized profit or loss for the account. unrealized_pnl: type: string format: decimal pattern: ^-?\d{0,26}(?:\.\d{0,2})?$ readOnly: true nullable: true description: Unrealized profit or loss from currently open exposure. total_pnl: type: string format: decimal pattern: ^-?\d{0,26}(?:\.\d{0,2})?$ readOnly: true nullable: true description: Realized lifetime profit or loss for the account. realized_lifetime_pnl: type: string format: decimal pattern: ^-?\d{0,26}(?:\.\d{0,2})?$ readOnly: true nullable: true description: Realized lifetime profit or loss for the account. total_commission: type: string format: decimal pattern: ^-?\d{0,26}(?:\.\d{0,2})?$ readOnly: true nullable: true description: Total commission charged to the account. closed_pnl_today: type: string readOnly: true description: >- Realized profit or loss from positions closed during the current trading day. open_pnl: type: string readOnly: true description: >- Legacy open-position profit or loss value. Prefer unrealized_pnl when present. open_positions_count: type: string readOnly: true description: Number of currently open positions. peak_realized_balance: type: string readOnly: true description: >- Highest realized account balance reached for the relevant risk window. peak_balance: type: string format: decimal pattern: ^-?\d{0,24}(?:\.\d{0,4})?$ readOnly: true nullable: true description: >- Peak realized account balance for the relevant risk window, excluding open-position profit or loss. peak_equity: type: string format: decimal pattern: ^-?\d{0,24}(?:\.\d{0,4})?$ readOnly: true nullable: true description: >- Peak account equity for the relevant risk window, including open-position profit or loss. peak_equity_timestamp: type: string format: date-time readOnly: true nullable: true description: Timestamp when the peak account equity was recorded. lowest_realized_balance: type: string readOnly: true description: Lowest realized account balance reached historically. peak_unrealized_balance: type: string readOnly: true description: Highest account equity reached for the relevant risk window. lowest_unrealized_balance: type: string readOnly: true description: Lowest unrealized equity value reached historically. low_equity_timestamp: type: string format: date-time readOnly: true nullable: true description: Timestamp when the lowest account equity was recorded. eod_peak_balance: type: string format: decimal pattern: ^-?\d{0,24}(?:\.\d{0,4})?$ readOnly: true nullable: true description: End-of-day peak balance used for EOD trailing drawdown calculations. failure_threshold: type: string format: decimal pattern: ^-?\d{0,24}(?:\.\d{0,4})?$ readOnly: true nullable: true description: Current account failure threshold supplied by OMS, when available. daily_drawdown_floor: type: string format: decimal pattern: ^-?\d{0,24}(?:\.\d{0,4})?$ readOnly: true nullable: true description: Current daily drawdown floor supplied by OMS, when available. account_currency: type: string readOnly: true description: Currency in which the trading account is denominated. auto_liquidation_eNonebled: type: string readOnly: true nullable: true description: >- Deprecated legacy field retaining its historical spelling. Account-level auto-liquidation data is unavailable; this field always returns null. auto_liquidation_enabled: type: boolean readOnly: true nullable: true description: >- Whether account-level auto-liquidation is enabled. This data is unavailable and always returns null. See auto_liquidation_data_status. auto_liquidation_data_status: allOf: - $ref: '#/components/schemas/AutoLiquidationDataStatusEnum' readOnly: true default: unavailable description: >- Deprecated availability indicator for account-level auto-liquidation data. Always unavailable. * `unavailable` - unavailable auto_liquidation_criteria: type: string readOnly: true nullable: true description: >- Deprecated legacy field. Account-level auto-liquidation data is unavailable; this field always returns null. auto_liquidation_triggered: type: string readOnly: true nullable: true description: >- Deprecated legacy field. Account-level auto-liquidation data is unavailable; this field always returns null. auto_liquidation_timestamp: type: string readOnly: true nullable: true description: >- Deprecated legacy field. Account-level auto-liquidation data is unavailable; this field always returns null. long_positions_count: type: string readOnly: true description: Number of open long (buy) positions. short_positions_count: type: string readOnly: true description: Number of open short (sell) positions. net_positions_count: type: string readOnly: true description: Net number of open positions (long minus short). is_trading_allowed: type: string readOnly: true description: Indicates whether the account is currently allowed to place trades. oms_flags: type: string readOnly: true description: Operational or risk flags reported for the account. last_trade_timestamp: type: string readOnly: true description: Timestamp of the most recent trade executed on the account. risk_algorithm: type: string readOnly: true description: Risk management algorithm currently applied to the account. drawdown_type: type: string readOnly: true description: Type of drawdown applied to the account (e.g. static, trailing). max_drawdown: type: string readOnly: true description: Maximum allowed drawdown for the account. daily_max_drawdown: type: string readOnly: true description: Maximum allowed daily drawdown for the account. minimum_account_balance: type: string format: decimal pattern: ^-?\d{0,24}(?:\.\d{0,4})?$ readOnly: true nullable: true description: Lowest observed account balance for the relevant risk window. minimum_account_balance_timestamp: type: string readOnly: true description: >- Timestamp when the lowest observed account balance was recorded, if applicable. trading_days: type: string readOnly: true description: Number of distinct trading days with at least one executed trade. consistency_score: type: string readOnly: true description: >- Score representing the trader's consistency based on risk and performance metrics. initial_balance_decimal: type: string readOnly: true current_balance_decimal: type: string readOnly: true created: type: string format: date-time readOnly: true modified: type: string format: date-time readOnly: true deleted: type: boolean default: false comment: type: string nullable: true maxLength: 255 is_giveaway: type: boolean default: false start_date: type: string format: date-time nullable: true end_date: type: string format: date-time nullable: true description: >- Specified for Time Limited accounts. Leave blank to allow unlimited duration source: allOf: - $ref: '#/components/schemas/SourceEnum' default: WEBHOOK initial_balance: type: string format: decimal pattern: ^-?\d{0,12}(?:\.\d{0,2})?$ default: '0.00' live_account_balance_currency: type: string readOnly: true live_account_equity_currency: type: string readOnly: true live_account_equity: type: string format: decimal pattern: ^-?\d{0,26}(?:\.\d{0,2})?$ default: '0.00' leverage: type: string format: decimal pattern: ^-?\d{0,3}(?:\.\d{0,2})?$ nullable: true mae: type: string format: decimal pattern: ^-?\d{0,26}(?:\.\d{0,2})?$ nullable: true mfe: type: string format: decimal pattern: ^-?\d{0,26}(?:\.\d{0,2})?$ nullable: true mae_timestamp: type: string format: date-time nullable: true mfe_timestamp: type: string format: date-time nullable: true min_balance: type: string format: decimal pattern: ^-?\d{0,24}(?:\.\d{0,4})?$ nullable: true description: Lowest observed account balance for the relevant risk window. min_balance_timestamp: type: string format: date-time nullable: true profit_loss_currency: type: string readOnly: true profit_loss: type: string format: decimal pattern: ^-?\d{0,12}(?:\.\d{0,2})?$ default: '0.00' broker_type: allOf: - $ref: '#/components/schemas/BrokerTypeEnum' default: TickblazeOMS last_daily_drawdown_amount_currency: type: string readOnly: true nullable: true last_daily_drawdown_amount: type: string format: decimal pattern: ^-?\d{0,12}(?:\.\d{0,2})?$ nullable: true last_global_drawdown_amount_currency: type: string readOnly: true nullable: true last_global_drawdown_amount: type: string format: decimal pattern: ^-?\d{0,12}(?:\.\d{0,2})?$ nullable: true daily_drawdown_expiry: type: string format: date-time nullable: true status: allOf: - $ref: '#/components/schemas/Status293Enum' default: ACTIVE status_finalised_timestamp: type: string format: date-time nullable: true status_reason: nullable: true oneOf: - $ref: '#/components/schemas/StatusReasonEnum' - $ref: '#/components/schemas/BlankEnum' - $ref: '#/components/schemas/NullEnum' custom_status_reason: type: string nullable: true profit_split: type: string format: decimal pattern: ^-?\d{0,1}(?:\.\d{0,2})?$ nullable: true description: Percentage value (0 to 1) payout_frequency: allOf: - $ref: '#/components/schemas/PayoutFrequencyEnum' default: 30 minimum: -2147483648 maximum: 2147483647 next_withdrawal_date: type: string format: date-time nullable: true copy_trading_detected: type: boolean default: false failed_review_reason: type: string nullable: true first_withdrawal_delay: type: integer maximum: 2147483647 minimum: -2147483648 nullable: true reconciliation_status: allOf: - $ref: '#/components/schemas/ReconciliationStatusEnum' default: not_reconciled reconciliation_transferred_at: type: string format: date-time nullable: true reconciliation_note: type: string nullable: true max_position_size_account: type: string format: decimal pattern: ^-?\d{0,10}(?:\.\d{0,3})?$ nullable: true order: type: integer nullable: true phase: type: integer nullable: true match_trader_trading_account: type: string format: uuid nullable: true metatrader_trading_account: type: integer nullable: true metatrader5_trading_account: type: integer nullable: true tradelocker_trading_account: type: string nullable: true sim2funded_trading_account: type: integer nullable: true ctrader_trading_account: type: integer nullable: true tradovate_trading_account: type: integer nullable: true volumetrica_trading_account: type: string nullable: true reconciliation_original_account: type: integer nullable: true reconciliation_superseded_by: type: integer nullable: true required: - account_currency - account_type - auto_liquidate_triggered_timestamp - auto_liquidation_criteria - auto_liquidation_data_status - auto_liquidation_eNonebled - auto_liquidation_enabled - auto_liquidation_timestamp - auto_liquidation_triggered - challenge_short_code - challenge_title - closed_pnl_today - consistency_score - created - current_balance - current_balance_decimal - current_equity - daily_drawdown_floor - daily_max_drawdown - daily_pnl - drawdown_type - email - eod_peak_balance - failure_metadata - failure_threshold - id - initial_balance_decimal - is_trading_allowed - last_daily_drawdown_amount_currency - last_global_drawdown_amount_currency - last_trade_timestamp - live_account_balance_currency - live_account_equity_currency - long_positions_count - low_equity_timestamp - lowest_realized_balance - lowest_unrealized_balance - max_drawdown - minimum_account_balance - minimum_account_balance_timestamp - modified - net_positions_count - oms_flags - open_pnl - open_positions_count - peak_balance - peak_equity - peak_equity_timestamp - peak_realized_balance - peak_unrealized_balance - previous_end_of_day_balance - profit_loss_currency - prop_firm_id - prop_firm_name - realized_lifetime_pnl - realized_pnl - risk_algorithm - short_positions_count - total_commission - total_pnl - trading_days - unrealized_pnl - user_id AutoLiquidationDataStatusEnum: enum: - unavailable type: string description: '* `unavailable` - unavailable' SourceEnum: enum: - WEBHOOK - ADMIN_MANUAL_CREATE - ADMIN_VERIFICATION - DATA_IMPORT type: string description: |- * `WEBHOOK` - Webhook * `ADMIN_MANUAL_CREATE` - Admin Manual Create * `ADMIN_VERIFICATION` - Admin Verification * `DATA_IMPORT` - Data Import BrokerTypeEnum: enum: - ALL - MatchTrade - MetaTrader - TradeLocker - MetaTrader5 - Ctrader - Sim2Funded - Tradovate - Volumetrica - Tickblaze - TickblazeOMS type: string description: |- * `ALL` - Do not filter * `MatchTrade` - Match Trader * `MetaTrader` - MetaTrader * `TradeLocker` - TradeLocker * `MetaTrader5` - MetaTrader5 * `Ctrader` - Ctrader * `Sim2Funded` - Sim2Funded * `Tradovate` - Tradovate * `Volumetrica` - Volumetrica * `Tickblaze` - Tickblaze * `TickblazeOMS` - TickblazeOMS Status293Enum: enum: - PENDING_ACTIVATION - ACTIVE - PASSED - FAILED - BLOCKED - DELETED - LIVE_VERIFICATION - KYC_VERIFICATION_REQD - PHASE_VERIFICATION_REQD - PAUSED - SUBSCRIPTION_EXPIRED - PAYMENT_REQUESTED type: string description: |- * `PENDING_ACTIVATION` - Pending Activation * `ACTIVE` - Active * `PASSED` - Passed * `FAILED` - Failed * `BLOCKED` - Blocked * `DELETED` - Deleted * `LIVE_VERIFICATION` - Live Account Verification Required * `KYC_VERIFICATION_REQD` - KYC Verification Required * `PHASE_VERIFICATION_REQD` - Phase Verification Required * `PAUSED` - PAUSED * `SUBSCRIPTION_EXPIRED` - Subscription Expired * `PAYMENT_REQUESTED` - Payment Requested StatusReasonEnum: enum: - DAILY_DRAWDOWN_EXCEEDED - MAX_DRAWDOWN_EXCEEDED - FLOATING_PNL_EXCEEDED - PROFIT_TARGET_REACHED - ACCOUNT_EXPIRED - TRADING_STRATEGY_NOT_SUITABLE - COPY_TRADING_DETECTED - RULE_BREACHED - WITHDRAWAL_REQUESTED - CHALLENGE_RESET - SUBSCRIPTION_EXPIRED type: string description: >- * `DAILY_DRAWDOWN_EXCEEDED` - Daily drawdown limit exceeded * `MAX_DRAWDOWN_EXCEEDED` - Maximum drawdown limit exceeded * `FLOATING_PNL_EXCEEDED` - Floating PNL limit exceeded * `PROFIT_TARGET_REACHED` - Profit target completed * `ACCOUNT_EXPIRED` - Account expired * `TRADING_STRATEGY_NOT_SUITABLE` - Trading strategy does not suit our Organization * `COPY_TRADING_DETECTED` - Copy trading detected * `RULE_BREACHED` - Rule Breached * `WITHDRAWAL_REQUESTED` - Withdrawal Requested * `CHALLENGE_RESET` - Challenge Reset * `SUBSCRIPTION_EXPIRED` - Subscription Expired BlankEnum: enum: - '' NullEnum: enum: - null PayoutFrequencyEnum: enum: - 30 - 14 - 7 - 10 - 3 - 5 - -1 - 21 - 28 - 1 type: integer description: |- * `30` - Monthly * `14` - Bi-Weekly * `7` - Weekly * `10` - Every 10 days * `3` - Every 3 days * `5` - Every 5 days * `-1` - Triple Payout * `21` - Every 21 days * `28` - Every 28 days * `1` - Daily ReconciliationStatusEnum: enum: - not_reconciled - original_superseded - replacement_account type: string description: |- * `not_reconciled` - Not reconciled * `original_superseded` - Original superseded * `replacement_account` - Replacement account securitySchemes: tokenAuth: type: apiKey in: header name: Authorization description: Token-based authentication with required prefix "Token" ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.