# Get Account Detail

Retrieves the detailed information of a specific account.

# OpenAPI definition

```json
{
  "info": {
    "title": "Webull Open API Reference",
    "description": "application.yml\\ncom\\ni18n\\nMETA-INF\\nstatic\\n\\r\\n",
    "contact": {
      "name": "",
      "url": "",
      "email": ""
    },
    "version": "2.0",
    "x-logo": {
      "url": "static/png/logo.png"
    }
  },
  "servers": [
    {
      "url": "https://broker-api.sandbox.webull.com"
    }
  ],
  "path": "/broker/accounts/get",
  "method": "get",
  "tags": [
    "Accounts"
  ],
  "description": "Retrieves the detailed information of a specific account.",
  "operationId": "getAccountDetail",
  "parameters": [
    {
      "name": "account_id",
      "in": "query",
      "description": "Unique identifier of the account to query restrictions for.",
      "required": true,
      "schema": {
        "type": "string"
      },
      "example": "f47ac10b58cc4372a5670e02b2c3d479"
    },
    {
      "name": "x-app-key",
      "in": "header",
      "description": "A unique identifier issued to a developer for accessing an application's API.",
      "required": true,
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "x-app-secret",
      "in": "header",
      "description": "A unique key issued to developers to access the application's API.",
      "required": true,
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "x-timestamp",
      "in": "header",
      "description": "Timestamp of the request, follows ISO8601 format: YYYY-MM-DDThh:mm:ssZ, e.g. 2023-07-16T19:23:51Z, only supports UTC time zone.",
      "required": true,
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "x-signature-version",
      "in": "header",
      "description": "Signature algorithm version, default is 1.0.",
      "required": true,
      "schema": {
        "type": "string",
        "default": "1.0"
      },
      "examples": {
        "1.0": {
          "value": "1.0"
        }
      }
    },
    {
      "name": "x-signature-algorithm",
      "in": "header",
      "description": "Signature algorithm, default is HMAC-SHA1.",
      "required": true,
      "schema": {
        "type": "string",
        "default": "HMAC-SHA1"
      },
      "examples": {
        "HMAC-SHA1": {
          "value": "HMAC-SHA1"
        }
      }
    },
    {
      "name": "x-signature-nonce",
      "in": "header",
      "description": "Signature unique random number.",
      "required": true,
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "x-version",
      "in": "header",
      "description": "API interface version. Supported values: `v2`, `v3`.",
      "required": true,
      "schema": {
        "type": "string",
        "default": "v3"
      },
      "examples": {
        "v3": {
          "value": "v3"
        }
      }
    },
    {
      "name": "x-signature",
      "in": "header",
      "description": "A signature is a unique digital fingerprint, typically encrypted, that verifies the authenticity and integrity of a message or transaction, ensuring it has not been tampered with during transmission.",
      "required": true,
      "schema": {
        "type": "string"
      }
    }
  ],
  "responses": {
    "200": {
      "description": "OK",
      "content": {
        "application/json": {
          "schema": {
            "required": [
              "account_id",
              "account_number",
              "account_type"
            ],
            "type": "object",
            "properties": {
              "account_id": {
                "type": "string",
                "description": "Unique identifier of the account to which restrictions are currently applied.",
                "example": "f47ac10b58cc4372a5670e02b2c3d479"
              },
              "account_number": {
                "type": "string",
                "description": "Account number associated with the account.",
                "example": "U1234567"
              },
              "account_type": {
                "type": "string",
                "description": "Account Type<br/>CASH - Cash Account Type<br/>MARGIN - Margin Account Type<br/>",
                "enum": [
                  "CASH",
                  "MARGIN"
                ]
              },
              "rep_code": {
                "type": "string",
                "description": "Rep Code",
                "example": "REP001"
              },
              "commission_code": {
                "type": "string",
                "description": "Commission Code",
                "example": "COM001"
              },
              "restrict_infos": {
                "type": "array",
                "description": "List of restrictions currently effective for this account. ",
                "items": {
                  "required": [
                    "restriction_code",
                    "restriction_start_time"
                  ],
                  "type": "object",
                  "properties": {
                    "restriction_code": {
                      "type": "string",
                      "description": "A code representing the type of restriction applied. <br/>RISK: Risk Restriction<br/>TRADING: Trading Restriction<br/>TRADING_STOCK_ETF: Stock and ETF Trading Restriction<br/>TRADING_FRACTIONAL: Fractional Share Trading Restriction<br/>TRADING_OPTIONS: Options Trading Restriction<br/>TRADING_EVENT: Event Contract Trading Restriction<br/>TRADING_OTC: OTC Trading Restriction<br/>TRADING_OVERNIGHT: Overnight Trading Restriction<br/>ACCOUNT_LINKING: Account Linking Restriction<br/>FUNDING_ACH: ACH Deposit Restriction<br/>FUNDING_DEBIT_CARD: Debit Card Deposit Restriction<br/>FUNDING_DIRECT_DEPOSIT: Direct Deposit Restriction<br/>WITHDRAWAL: Withdrawal Restriction<br/>TRANSFER_ACATS_IN: ACATS Incoming Transfer Restriction<br/>TRANSFER_ACATS_OUT: ACATS Outgoing Transfer Restriction",
                      "example": "RISK"
                    },
                    "restriction_start_time": {
                      "type": "string",
                      "description": "The date and time when the restriction takes effect. Time in ISO8601 format (UTC). Format: yyyy-MM-dd'T'HH:mm:ss.SSS'Z'",
                      "example": "2025-01-06T22:59:59.012Z"
                    },
                    "reason": {
                      "type": "string",
                      "description": "A description of the reason for the restriction.",
                      "example": "Unusual trading activity detected on 2025-01-05."
                    }
                  },
                  "description": "RestrictInfo",
                  "title": "RestrictInfo"
                }
              }
            },
            "description": "Account Detail Response",
            "title": "AccountDetailResult"
          }
        }
      }
    },
    "401": {
      "description": "Unauthorized: Authentication required",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error_code": {
                "type": "string",
                "description": "Internal logic error code",
                "example": "UNAUTHORIZED"
              },
              "message": {
                "type": "string",
                "description": "Error message",
                "example": "Insufficient permission"
              }
            }
          }
        }
      }
    },
    "417": {
      "description": "A business logic error triggered when the request cannot be processed due to domain-specific constraints.",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error_code": {
                "type": "string",
                "description": "Internal logic error code",
                "example": "INVALID_PARAMETER"
              },
              "message": {
                "type": "string",
                "description": "Error message",
                "example": "Parameter error, phone"
              }
            }
          }
        }
      }
    },
    "500": {
      "description": "Internal Server Error.",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error_code": {
                "type": "string",
                "description": "Internal logic error code",
                "example": "SYSTEM_ERROR"
              },
              "message": {
                "type": "string",
                "description": "Error message",
                "example": "Internal Server Error"
              }
            }
          }
        }
      }
    }
  },
  "postman": {
    "name": "Get Account Detail",
    "description": {
      "content": "Retrieves the detailed information of a specific account.",
      "type": "text/plain"
    },
    "url": {
      "path": [
        "broker",
        "accounts",
        "get"
      ],
      "host": [
        "{{baseUrl}}"
      ],
      "query": [
        {
          "disabled": false,
          "description": {
            "content": "(Required) Unique identifier of the account to query restrictions for.",
            "type": "text/plain"
          },
          "key": "account_id",
          "value": ""
        }
      ],
      "variable": []
    },
    "header": [
      {
        "disabled": false,
        "description": {
          "content": "(Required) A unique identifier issued to a developer for accessing an application's API.",
          "type": "text/plain"
        },
        "key": "x-app-key",
        "value": ""
      },
      {
        "disabled": false,
        "description": {
          "content": "(Required) A unique key issued to developers to access the application's API.",
          "type": "text/plain"
        },
        "key": "x-app-secret",
        "value": ""
      },
      {
        "disabled": false,
        "description": {
          "content": "(Required) Timestamp of the request, follows ISO8601 format: YYYY-MM-DDThh:mm:ssZ, e.g. 2023-07-16T19:23:51Z, only supports UTC time zone.",
          "type": "text/plain"
        },
        "key": "x-timestamp",
        "value": ""
      },
      {
        "disabled": false,
        "description": {
          "content": "(Required) Signature algorithm version, default is 1.0.",
          "type": "text/plain"
        },
        "key": "x-signature-version",
        "value": ""
      },
      {
        "disabled": false,
        "description": {
          "content": "(Required) Signature algorithm, default is HMAC-SHA1.",
          "type": "text/plain"
        },
        "key": "x-signature-algorithm",
        "value": ""
      },
      {
        "disabled": false,
        "description": {
          "content": "(Required) Signature unique random number.",
          "type": "text/plain"
        },
        "key": "x-signature-nonce",
        "value": ""
      },
      {
        "disabled": false,
        "description": {
          "content": "(Required) API interface version. Supported values: `v2`, `v3`.",
          "type": "text/plain"
        },
        "key": "x-version",
        "value": ""
      },
      {
        "disabled": false,
        "description": {
          "content": "(Required) A signature is a unique digital fingerprint, typically encrypted, that verifies the authenticity and integrity of a message or transaction, ensuring it has not been tampered with during transmission.",
          "type": "text/plain"
        },
        "key": "x-signature",
        "value": ""
      },
      {
        "key": "Accept",
        "value": "application/json"
      }
    ],
    "method": "GET"
  }
}
```