---
title: "Get Account Information"
method: GET
path: "/gw/api/v1/accounts/{accountId}/details"
tags: ["accountManagementAccounts"]
---

# Get Account Information

`GET /gw/api/v1/accounts/{accountId}/details`

<br>**Scope**: `accounts.read`<br>**Security Policy**: `HTTPS`

## Path parameters

- `accountId` string, required

## Response `200`

View information associated with account including contact data, financial information and trading configuration.

- AccountDetailsResponse
  - `error` ErrorResponse
    - `status` integer
    - `error` string
    - `message` string
  - `hasError` boolean
  - `errorDescription` string
  - `account` AccountData
    - `accountId` string
    - `masterAccountId` string
    - `mainAccount` string
    - `sourceAccountId` string
    - `primaryUser` string
    - `clearingStatus` string
    - `clearingStatusDescription` string
    - `stateCode` string
    - `optionLevel` integer
    - `baseCurrency` string
    - `dateBegun` string
    - `dateApproved` string
    - `dateOpened` string
    - `dateFunded` string
    - `dateClosed` string
    - `dateLinked` string
    - `dateDelinked` string
    - `accountTitle` string
    - `officialTitle` string
    - `accountAlias` string
    - `emailAddress` string
    - `margin` string
    - `applicantType` string
    - `subType` string
    - `stockYieldProgram` object
    - `feeTemplate` object
    - `capabilities` object
    - `limitedOptionTrading` string
    - `investmentObjectives` string[]
    - `dividendReinvestment` object
    - `externalId` string
    - `mifidCategory` string
    - `mifirStatus` string
    - `equity` number, double
    - `household` string
    - `propertyProfile` string
    - `processType` string
    - `riskScore` integer
    - `class_action_program` string
    - `trustType` string
    - `orgType` string
    - `businessDescription` string
    - `usTaxPurposeType` string
    - `tradeIntentionType` string
    - `registeredAddress` object
    - `mailing` object
    - `countryOfCorporation` string
    - `taxIds` object[]
    - `taxTreatyDetails` object[]
    - `signatures` string[]
  - `associatedPersons` AssociatedPerson[]
    - `entityId` integer
    - `externalCode` string
    - `firstName` string
    - `middleName` string
    - `middleInitial` string
    - `lastName` string
    - `suffix` string
    - `username` string
    - `passwordDate` string
    - `userStatus` string
    - `userStatusTrading` string
    - `lastLogin` string
    - `gender` string
    - `maritalStatus` string
    - `salutation` string
    - `ownershipPercentage` number, double
    - `email` string
    - `countryOfCitizenship` string
    - `countryOfBirth` string
    - `dateOfBirth` string
    - `motersMaidenName` string
    - `numberOfDependents` integer
    - `securityDevice` string
    - `commercial` string
    - `countryOfLegalResidence` string
    - `stateOfLegalResidence` string
    - `mdSubscriberStatus` string
    - `phones` object
    - `residence` object
    - `mailing` object
    - `associations` string[]
    - `identityDocuments` object[]
    - `employmentType` string
    - `employmentDetails` object
    - `subscribedServices` object[]
    - `taxTreatyDetails` object[]
  - `associatedEntities` AssociatedEntity[]
    - `entityId` integer
    - `externalCode` string
    - `name` string
    - `email` string
    - `organizationCountry` string
    - `phones` object
    - `residence` object
    - `mailing` object
    - `associations` string[]
    - `identityDocuments` object[]
    - `taxTreatyDetails` object[]
    - `AssociatedPersons` AssociatedPerson[]
      - `entityId` integer
      - `externalCode` string
      - `firstName` string
      - `middleName` string
      - `middleInitial` string
      - `lastName` string
      - `suffix` string
      - `username` string
      - `passwordDate` string
      - `userStatus` string
      - `userStatusTrading` string
      - `lastLogin` string
      - `gender` string
      - `maritalStatus` string
      - `salutation` string
      - `ownershipPercentage` number, double
      - `email` string
      - `countryOfCitizenship` string
      - `countryOfBirth` string
      - `dateOfBirth` string
      - `motersMaidenName` string
      - `numberOfDependents` integer
      - `securityDevice` string
      - `commercial` string
      - `countryOfLegalResidence` string
      - `stateOfLegalResidence` string
      - `mdSubscriberStatus` string
      - `phones` object
      - `residence` object
      - `mailing` object
      - `associations` string[]
      - `identityDocuments` object[]
      - `employmentType` string
      - `employmentDetails` object
      - `subscribedServices` object[]
      - `taxTreatyDetails` object[]
  - `withHoldingStatement` object
  - `marketData` object[]
  - `financialInformation` object
  - `sourcesOfWealth` object[]
  - `tradeBundles` string[]
  - `individualIRABeneficiaries` IndividualIRABene[]
    - `firstName` string
    - `lastName` string
    - `dateOfBirth` string
    - `type` string
    - `identification` object
    - `location` object
    - `relationship` string
    - `ownership` integer
    - `perStripes` string
  - `entityIRABeneficiaries` EntityIRABene[]
    - `name` string
    - `entityType` string
    - `type` string
    - `location` object
    - `articleOfWill` string
  - `decedents` object[]
  - `restrictions` RestrictionInfo[]
    - `id` integer
    - `byIB` boolean
    - `name` string

## Other responses

- `400` — Returns error description representing bad request
- `401` — Returns error description representing access issue
- `403` — Returns error description representing access issue
- `500` — Returns error description representing internal server error

---

[API](https://skmtc.net/interactivebrokers/apis/api-reference.md) · [All operations](https://skmtc.net/interactivebrokers/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/interactivebrokers/api-reference/revisions/67f9f562c2c6/schema)