> ## 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 user details

> Returns a single user with annotated account counts.



## OpenAPI

````yaml /openapi.json get /api/users/{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 <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/users/{id}/:
    get:
      tags:
        - Users
      summary: Retrieve user details
      description: Returns a single user with annotated account counts.
      operationId: api_users_retrieve
      parameters:
        - in: path
          name: id
          schema:
            type: integer
          description: A unique integer value identifying this user.
          required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserTickblazeManager'
              examples:
                UserResponse:
                  value:
                    id: 123
                    email: jane.doe@example.com
                    full_name: Jane Doe
                    ip_addresses:
                      - 203.0.113.42
                      - 198.51.100.17
                    country_code: US
                    state: CA
                    postcode: '94105'
                    kyc_verified: verified
                    city: San Francisco
                    address_1: 123 Market Street
                    address_2: Suite 500
                    phone: +1-415-555-0199
                    blocked: false
                    prop_firm:
                      prop_firm_id: 507ede8b-951d-4c38-877a-f242463ce14f
                      prop_firm_name: Example Firm
                      prop_firm_slug: example-firm
                      account_count: 42
                      created_at: '2021-06-18T10:42:15Z'
                      contact_email: support@example.com
                    user_type: pro
                    total_accounts_purchased: 12
                    total_active_accounts: 8
                    total_failed_accounts: 4
                    duplicate_group:
                      count: 2
                      emails:
                        - jane.doe@example.com
                        - jane.alt@example.com
                      csv: jane.doe@example.com,jane.alt@example.com
                    trading_status: enabled
                    entitlements:
                      - name: CME Market Data
                        data_level: l1
                        exchanges:
                          - cbot
                          - nymex
                        status: AUTHORIZED
                        authorized_at: '2026-03-20T09:15:00Z'
                  summary: User response
          description: ''
      security:
        - tokenAuth: []
components:
  schemas:
    UserTickblazeManager:
      type: object
      description: |-
        Serializer used by the Tickblaze Manager.

        Exposes user fields relevant to account oversight.
      properties:
        id:
          type: integer
          readOnly: true
        email:
          type: string
          format: email
          readOnly: true
        full_name:
          type: string
          maxLength: 100
        ip_addresses:
          type: array
          items:
            type: string
        country_code:
          type: string
          nullable: true
          maxLength: 100
        state:
          type: string
          nullable: true
          maxLength: 100
        postcode:
          type: string
          nullable: true
          maxLength: 100
        kyc_verified:
          type: string
          readOnly: true
        city:
          type: string
          nullable: true
          maxLength: 100
        address_1:
          type: string
          nullable: true
          maxLength: 500
        address_2:
          type: string
          nullable: true
          maxLength: 500
        phone:
          type: string
          nullable: true
          maxLength: 100
        blocked:
          type: string
          readOnly: true
        created:
          type: string
          format: date-time
          readOnly: true
        prop_firm:
          type: string
          readOnly: true
        user_type:
          type: string
          readOnly: true
          description: >-
            Self-cert classification: `pro` when the pro declaration is
            accepted, otherwise `non pro`.
        total_accounts_purchased:
          type: integer
          readOnly: true
        total_active_accounts:
          type: integer
          readOnly: true
        total_failed_accounts:
          type: integer
          readOnly: true
        duplicate_group:
          type: string
          readOnly: true
        trading_status:
          type: string
          readOnly: true
        entitlements:
          type: string
          readOnly: true
          description: Entitlements for the user.
      required:
        - blocked
        - created
        - duplicate_group
        - email
        - entitlements
        - full_name
        - id
        - kyc_verified
        - prop_firm
        - total_accounts_purchased
        - total_active_accounts
        - total_failed_accounts
        - trading_status
        - user_type
  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.