> ## 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.

# List disabled trading accounts

> Returns currently disabled accounts. By default the endpoint returns accounts disabled within the rolling last 24 hours. Callers may pass `start_date` and `end_date` in `YYYY-MM-DD` to request an inclusive range up to 31 days.



## OpenAPI

````yaml /openapi.json get /api/accounts/disabled/
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 <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/disabled/:
    get:
      tags:
        - Accounts
      summary: List disabled trading accounts
      description: >-
        Returns currently disabled accounts. By default the endpoint returns
        accounts disabled within the rolling last 24 hours. Callers may pass
        `start_date` and `end_date` in `YYYY-MM-DD` to request an inclusive
        range up to 31 days.
      operationId: api_accounts_disabled_retrieve
      parameters:
        - in: query
          name: end_date
          schema:
            type: string
            format: date
          description: >-
            Inclusive end date in `YYYY-MM-DD`. Defaults to the rolling last 24
            hours when omitted.
        - in: query
          name: page
          schema:
            type: integer
          description: Page number for paginated responses.
        - in: query
          name: page_size
          schema:
            type: integer
          description: Number of records per page.
        - in: query
          name: start_date
          schema:
            type: string
            format: date
          description: >-
            Inclusive start date in `YYYY-MM-DD`. Defaults to the rolling last
            24 hours when omitted.
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedAccountDisabledList'
              examples:
                DefaultLast24HoursResponse:
                  value:
                    meta:
                      count: 123
                      page: 1
                      page_size: 20
                      total_pages: 7
                      has_next: true
                      has_previous: false
                      next: https://api.example.org/resources/?page=2
                      previous: null
                    results:
                      - account_id: 1204
                        status: FAILED
                        disabled_at: '2026-04-05T13:15:00Z'
                        reason: Daily drawdown breached during London session
                  summary: Latest disabled accounts
          description: >-
            Paginated list of currently disabled accounts ordered by most recent
            disable timestamp.
      security:
        - tokenAuth: []
components:
  schemas:
    PaginatedAccountDisabledList:
      type: object
      required:
        - meta
        - results
      properties:
        meta:
          type: object
          required:
            - count
            - page
            - page_size
            - total_pages
            - has_next
            - has_previous
            - next
            - previous
          description: >-
            Pagination metadata. Use `has_next`/`has_previous` for boolean page
            checks and `next`/`previous` for page URLs.
          example:
            count: 123
            page: 1
            page_size: 20
            total_pages: 7
            has_next: true
            has_previous: false
            next: https://api.example.org/resources/?page=2
            previous: null
          properties:
            count:
              type: integer
              example: 123
              description: Total number of items matching the request.
            page:
              type: integer
              example: 1
              description: Current 1-indexed page number.
            page_size:
              type: integer
              example: 20
              description: Number of items returned per page.
            total_pages:
              type: integer
              example: 7
              description: Total number of pages available.
            has_next:
              type: boolean
              example: true
              description: Whether another page is available after this one.
            has_previous:
              type: boolean
              example: false
              description: Whether a page is available before this one.
            next:
              type: string
              nullable: true
              format: uri
              example: http://api.example.org/accounts/?page=2
              description: URL for the next page, or null on the final page.
            previous:
              type: string
              nullable: true
              format: uri
              example: null
              description: URL for the previous page, or null on the first page.
        results:
          type: array
          items:
            $ref: '#/components/schemas/AccountDisabled'
    AccountDisabled:
      type: object
      description: Compact payload returned by the disabled-account listing endpoint.
      properties:
        account_id:
          type: integer
          description: Trading account identifier.
        status:
          allOf:
            - $ref: '#/components/schemas/Status293Enum'
          description: |-
            Current terminal status for the account.

            * `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
        disabled_at:
          type: string
          format: date-time
          description: Timestamp when the account entered its current disabled state.
        reason:
          type: string
          nullable: true
          description: >-
            Custom disable reason when present, otherwise the stored status
            reason.
      required:
        - account_id
        - disabled_at
        - reason
        - status
    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
  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.