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

# Get Customer

`GET /customers/{customer_id}`

## Request

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

Returns the full customer resource, including name, addresses, suitability profile, and personal or entity details. For simplicity and security the customer's internal identifier is not exposed: pass `me` as the `customer_id` to fetch the customer linked to the current access token. Set `allow-missing=true` to avoid a 404 when the customer does not exist.

## Path parameters

- `customer_id` string, int32, required

## Query parameters

- `allow-missing` boolean

## Response `200`

The full customer resource for the requested customer.

- object
  - `data` Customer, required: A tastytrade customer, including name, residential and mailing addresses, suitability profile, and either personal or entity details. Fetched via GET /customers/{customer_id} using `me` as the identifier.
    - `id` string: Customer identifier. The API returns `me` rather than the internal id.
    - `first-name` string: Customer's first name.
    - `first-surname` string
    - `last-name` string: Customer's last name.
    - `middle-name` string
    - `prefix-name` string
    - `second-surname` string
    - `suffix-name` string
    - `cherry-club-date` string, date
    - `address` object
      - `city` string
      - `country` string
      - `is-domestic` string: Note: the wire value is a JSON boolean (e.g. true), although this schema declares a string.
      - `is-foreign` string: Note: the wire value is a JSON boolean (e.g. false), although this schema declares a string.
      - `postal-code` string
      - `state-region` string
      - `street-one` string
      - `street-three` string
      - `street-two` string
    - `customer-suitability` object
      - `id` string: Note: the wire value is a JSON number (e.g. 3), although this schema declares a string.
      - `annual-net-income` integer
      - `covered-options-trading-experience` string
      - `customer-id` integer
      - `employer-name` string
      - `employment-status` string
      - `futures-trading-experience` string
      - `job-title` string
      - `liquid-net-worth` integer
      - `marital-status` string
      - `net-worth` integer
      - `number-of-dependents` integer
      - `occupation` string
      - `stock-trading-experience` string
      - `tax-bracket` string
      - `uncovered-options-trading-experience` string
    - `mailing-address` object
      - `city` string
      - `country` string
      - `is-domestic` string: Note: the wire value is a JSON boolean (e.g. true), although this schema declares a string.
      - `is-foreign` string: Note: the wire value is a JSON boolean (e.g. false), although this schema declares a string.
      - `postal-code` string
      - `state-region` string
      - `street-one` string
      - `street-three` string
      - `street-two` string
    - `is-foreign` string: Whether the customer is classified as foreign. Note: the wire value is a JSON boolean (e.g. false), although this schema declares a string.
    - `regulatory-domain` string
    - `usa-citizenship-type` string: U.S. citizenship classification, for example Citizen.
    - `home-phone-number` string
    - `home-phone-number-details` string
    - `mobile-phone-number` string: Customer's mobile phone number, e.g. +11231234567.
    - `mobile-phone-number-details` string
    - `work-phone-number` string
    - `work-phone-number-details` string
    - `birth-date` string: Customer's date of birth (YYYY-MM-DD).
    - `email` string: Customer's email address.
    - `external-id` string: External customer identifier used by tastytrade's backoffice systems.
    - `foreign-tax-number` string
    - `tax-number` string: Masked tax identification number on file.
    - `tax-number-type` string: Type of tax identification number on file, for example SSN.
    - `birth-country` string
    - `citizenship-country` string: Country of citizenship.
    - `visa-expiration-date` string
    - `visa-type` string
    - `agreed-to-margining` boolean: Whether the customer has agreed to margining.
    - `subject-to-tax-withholding` boolean
    - `agreed-to-terms` boolean: Whether the customer has agreed to the account terms.
    - `signature-of-agreement` boolean
    - `desk-customer-id` string
    - `ext-crm-id` string
    - `family-member-names` string
    - `gender` string
    - `has-industry-affiliation` boolean
    - `has-institutional-assets` string
    - `has-listed-affiliation` boolean
    - `has-political-affiliation` boolean
    - `industry-affiliation-firm` string
    - `is-investment-adviser` string
    - `listed-affiliation-symbol` string
    - `political-organization` string
    - `user-id` string
    - `has-delayed-quotes` boolean: Whether the customer receives delayed market data quotes.
    - `has-pending-or-approved-application` string
    - `is-professional` boolean: Whether the customer is classified as a professional for market-data purposes.
    - `permitted-account-types` string
    - `created-at` string, date-time
    - `entity` object
      - `id` string
      - `address` object
        - `city` string
        - `country` string
        - `is-domestic` string
        - `is-foreign` string
        - `postal-code` string
        - `state-region` string
        - `street-one` string
        - `street-three` string
        - `street-two` string
      - `business-nature` string
      - `date-of-trust-creation` string
      - `email` string
      - `entity-officers` object[]
        - `id` string
        - `external-id` string
        - `first-name` string
        - `last-name` string
        - `middle-name` string
        - `prefix-name` string
        - `suffix-name` string
        - `address` object
          - `city` string
          - `country` string
          - `is-domestic` string
          - `is-foreign` string
          - `postal-code` string
          - `state-region` string
          - `street-one` string
          - `street-three` string
          - `street-two` string
        - `birth-country` string
        - `birth-date` string, date
        - `citizenship-country` string
        - `email` string
        - `employer-name` string
        - `employment-status` string
        - `home-phone-number` string
        - `is-foreign` string
        - `job-title` string
        - `marital-status` string
        - `mobile-phone-number` string
        - `number-of-dependents` string
        - `occupation` string
        - `owner-of-record` boolean
        - `relationship-to-entity` string
        - `tax-number` string
        - `tax-number-type` string
        - `usa-citizenship-type` string
        - `visa-expiration-date` string, date
        - `visa-type` string
        - `work-phone-number` string
      - `entity-suitability` object
        - `id` string
        - `annual-net-income` integer
        - `covered-options-trading-experience` string
        - `entity-id` integer
        - `futures-trading-experience` string
        - `liquid-net-worth` integer
        - `net-worth` integer
        - `stock-trading-experience` string
        - `tax-bracket` string
        - `uncovered-options-trading-experience` string
      - `entity-type` string
      - `foreign-institution` string
      - `grantor-birth-date` string
      - `grantor-email` string
      - `grantor-first-name` string
      - `grantor-last-name` string
      - `grantor-middle-name` string
      - `grantor-tax-number` string
      - `has-foreign-bank-affiliation` string
      - `has-foreign-institution-affiliation` string
      - `is-domestic` string
      - `is-hedge-fund` string
      - `legal-name` string
      - `mailing-address` object
        - `city` string
        - `country` string
        - `is-domestic` string
        - `is-foreign` string
        - `postal-code` string
        - `state-region` string
        - `street-one` string
        - `street-three` string
        - `street-two` string
      - `phone-number` string
      - `secretary-name` string
      - `tax-election` string
      - `tax-number` string
    - `identifiable-type` string: Whether the customer is identified as a Person or an Entity.
    - `person` object
      - `external-id` string
      - `first-name` string
      - `last-name` string
      - `middle-name` string
      - `prefix-name` string
      - `suffix-name` string
      - `birth-country` string
      - `birth-date` string, date
      - `citizenship-country` string
      - `usa-citizenship-type` string
      - `visa-expiration-date` string, date
      - `visa-type` string
      - `employer-name` string
      - `employment-status` string
      - `job-title` string
      - `marital-status` string
      - `number-of-dependents` string: Note: the wire value is a JSON number (e.g. 4), although this schema declares a string.
      - `occupation` string
  - `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 customer matches the supplied customer_id. Pass `me` to resolve the current customer, or set allow-missing=true to suppress this error.
- `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)