Accounts

Get Account By ID

Changed on Oct 16, 2026

Fetch account details by ID, including the mailing address, date of birth, phone number, and country of tax residency of the account-holder entity when on file.

get/v1/accounts/{account_id}

Request

Base URL
https://api.clearstreet.com
Auth
HTTP bearer

Path parameters

account_idinteger required

Account identifier

Response

Account details

Example response

{
  "error": {
    "code": 400,
    "message": "Order quantity must be greater than zero"
  },
  "metadata": {
    "page_number": 1,
    "total_items": 42,
    "total_pages": 5
  },
  "data": {
    "account_holder_entity_id": 987654321,
    "account_holder_entity_kind": "NATURAL_PERSON",
    "close_date": null,
    "country_of_tax_residency": "US",
    "date_of_birth": "1985-03-15",
    "full_name": "Test Trading Account",
    "id": 19816,
    "mailing_address": {
      "city": "New York",
      "country": "USA",
      "line1": "4 World Trade Center",
      "line2": "150 Greenwich Street, Floor 45",
      "postal_code": "10007",
      "state": "NY"
    },
    "open_date": "2023-01-15",
    "options_level": 1,
    "phone_number": "+12125550123",
    "short_name": "TST-ACCOUNT-01",
    "status": "ACTIVE",
    "subtype": "MARGIN",
    "type": "CUSTOMER"
  }
}

Changes

Oct 16, 20261bd9eddeffc8 Revision changes
- info
  added the required property //// to the response with the status
Jul 21, 202680e6fb2644e0 Revision changes
- breaking
  the / response's property type changed from object to no type for status
- breaking
  removed the required property // from the response with the status
- breaking
  removed the required property // from the response with the status
- breaking
  removed the required property // from the response with the status
- breaking
  removed the required property // from the response with the status
- breaking
  removed the required property // from the response with the status
- breaking
  removed the required property // from the response with the status
- breaking
  removed the required property // from the response with the status
- breaking
  removed the required property // from the response with the status
- breaking
  removed the required property // from the response with the status
- warning
  removed the optional property // from the response with the status
- info
  added subschema #1 subschema #2 to the / response property allOf list for the response status

Operation history