---
title: "Get Account"
method: GET
path: "/customers/{customer_id}/accounts/{account_number}"
tags: ["customers"]
---

# Get Account

`GET /customers/{customer_id}/accounts/{account_number}`

## Request

- Base URL: `https://api.cert.tastyworks.com`
- URL: `https://api.cert.tastyworks.com/customers/{customer_id}/accounts/{account_number}`
- Auth: none declared

Returns a single account resource by account number for the given customer. Use the account numbers returned by the list-accounts endpoint. Pass `me` as the `customer_id` to scope the lookup to the current customer.

## Path parameters

- `customer_id` string, int32, required
- `account_number` string, required

## Response `200`

The full account resource for the requested account number.

- object
  - `data` Account, required: A tastytrade brokerage account, including its identifiers, type, status flags, and suitability attributes.
    - `account-number` string: The unique tastytrade account number. Use this in account-scoped endpoint paths.
    - `account-type-name` string: Human-readable account type, for example Individual, Roth IRA, or Traditional IRA.
    - `closed-at` string, date-time: ISO-8601 timestamp at which the account was closed, if applicable.
    - `created-at` string, date-time: ISO-8601 timestamp at which the account record was created.
    - `day-trader-status` string: Whether the account is flagged as a pattern day trader. Note: the wire value is a JSON boolean (e.g. false), although this schema declares a string.
    - `ext-account-id` string
    - `ext-crm-id` string
    - `external-accounts` string
    - `external-fdid` string
    - `external-id` string: External account identifier used by tastytrade's backoffice systems.
    - `funding-date` string, date: Date the account was first funded (YYYY-MM-DD).
    - `futures-account-purpose` string: Stated purpose for futures trading on the account.
    - `investment-objective` string: The account's stated investment objective.
    - `investment-time-horizon` string
    - `is-closed` boolean: Whether the account is closed.
    - `is-firm-error` boolean: Whether the account is a firm error account.
    - `is-firm-proprietary` boolean: Whether the account is a firm proprietary account.
    - `is-foreign` string: Whether the account is associated with a foreign address. Note: the wire value is a JSON boolean (e.g. false), although this schema declares a string.
    - `is-futures-approved` boolean: Whether the account is approved to trade futures.
    - `liquidity-needs` string
    - `margin-or-cash` string: Whether the account is a Margin or Cash account.
    - `nickname` string: Customer-assigned nickname for the account.
    - `opened-at` string, date-time: ISO-8601 timestamp at which the account was opened.
    - `regulatory-domain` string
    - `risk-tolerance` string
    - `submitting-user-id` string
    - `suitable-options-level` string: The options trading level the account is approved for.
  - `context` string, required

## Other responses

- `401`: Missing or expired access token, or a missing/malformed User-Agent header. Send a valid Authorization: Bearer token and a User-Agent like my-app/1.0.
- `404`: No account matches the supplied account_number for this customer. Verify the account number and that you are using the correct environment (sandbox vs production).
- `429`: Request rate exceeded. Back off exponentially and reduce request rate.

---

[API](https://skmtc.dev/tastytrade/apis/accounts-and-customers.md) - [All operations](https://skmtc.dev/tastytrade/apis/accounts-and-customers/llms.txt) - [OpenAPI document](https://skmtc.dev/tastytrade/apis/accounts-and-customers/revisions/56a19159daf1?raw)