--- title: "List Customer Account Ownerships" method: GET path: "/customers/{id}/account-ownerships" tags: ["customers"] --- # List Customer Account Ownerships `GET /customers/{id}/account-ownerships` ## Request - Base URL: `https://api.engine.usesophic.com` - URL: `https://api.engine.usesophic.com/customers/{id}/account-ownerships` - Auth: HTTP bearer Retrieve the account ownerships for a customer. ## Path parameters - `id` string, required ## Response `200` OK - AccountOwnership[] - `account` Account, required - `bank_payment_reference` string, required: Reference used to identify bank payments for the account. - `base_currency` 'EUR' | 'USD' | 'GBP', required - `can_deposit` boolean, required: Whether deposits are currently allowed. - `can_place_buy_order` boolean, required: Whether buy orders are currently allowed. - `can_place_sell_order` boolean, required: Whether sell orders are currently allowed. - `can_withdraw` boolean, required: Whether withdrawals are currently allowed. - `created_at` string, date-time, required: The timestamp (in [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html) format) of when the resource was created. - `funding_currencies` Currency[], required: Currencies accepted for account funding. - `has_deposited` boolean, required: Whether the account has completed a deposit. - `has_placed_buy_order` boolean, required: Whether the account has placed a buy order. - `has_placed_sell_order` boolean, required: Whether the account has placed a sell order. - `has_withdrawn` boolean, required: Whether the account has completed a withdrawal. - `id` string, required: Unique resource identifier. - `is_primary_owner_mifid_pro` boolean, required: Whether the primary owner is classified as a MiFID professional. - `modified_at` string, date-time, required: The timestamp (in [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html) format) of when the resource was last modified. - `name` string, required: Display name of the account. - `reference` string, required: Customer-visible account reference. - `status` 'active' | 'suspended' | 'closing' | 'closed', required - `created_at` string, date-time, required: The timestamp (in [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html) format) of when the resource was created. - `customer` union, required: Customer that owns the account. - IndividualCustomer - `address` Address, required - `city` string, required: City or locality. - `country_code` string, required: ISO 3166-1 alpha-2 country code. - `district_county` string, nullable, required: District or county. - `line1` string, required: Primary street address line. - `line2` string, nullable, required: Additional street address line. - `line3` string, nullable, required: Further street address line. - `postal_code` string, required: Postal code. - `created_at` string, date-time, required: The timestamp (in [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html) format) of when the resource was created. - `customer_type` 'individual', required: Customer classification. - `date_of_birth` string, date-time, nullable, required: Customer's date and time of birth. - `first_name` string, required: Customer's first name. - `full_name` string, required: Customer's full display name. - `id` string, required: Unique resource identifier. - `id_number` string, nullable, required: Masked national identity number. - `last_name` string, required: Customer's last name. - `mifid_category` string, nullable, required: Customer's MiFID classification. - `modified_at` string, date-time, required: The timestamp (in [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html) format) of when the resource was last modified. - `nationalities` string[], nullable, required: ISO 3166-1 alpha-2 nationality codes. - `onboarding` string, nullable, required: ID of the customer's onboarding process. - `passport_number` string, nullable, required: Masked passport number. - `phone_number` string, nullable, required: Customer's primary phone number. - `reference` string, nullable, required: Customer-visible reference. - `referrer_code` string, nullable, required: Referral code associated with the customer. - `risk_profile` string, nullable, required: Customer's assigned risk profile. - `risk_score` string, nullable, required: Customer's risk score. - `status` 'active' | 'suspended' | 'closing' | 'closed', required - `tax_number` string, nullable, required: Masked tax identification number. - JointCustomer - `address` Address, required - `city` string, required: City or locality. - `country_code` string, required: ISO 3166-1 alpha-2 country code. - `district_county` string, nullable, required: District or county. - `line1` string, required: Primary street address line. - `line2` string, nullable, required: Additional street address line. - `line3` string, nullable, required: Further street address line. - `postal_code` string, required: Postal code. - `created_at` string, date-time, required: The timestamp (in [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html) format) of when the resource was created. - `customer_type` 'joint', required: Customer classification. - `first_name` string, nullable, required: Combined first names of the joint owners. - `full_name` string, required: Customer's full display name. - `id` string, required: Unique resource identifier. - `last_name` string, nullable, required: Combined last names of the joint owners. - `mifid_category` string, nullable, required: Customer's MiFID classification. - `modified_at` string, date-time, required: The timestamp (in [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html) format) of when the resource was last modified. - `onboarding` string, nullable, required: ID of the customer's onboarding process. - `phone_number` string, nullable, required: Customer's primary phone number. - `reference` string, nullable, required: Customer-visible reference. - `referrer_code` string, nullable, required: Referral code associated with the customer. - `risk_profile` string, nullable, required: Customer's assigned risk profile. - `risk_score` string, nullable, required: Customer's risk score. - `status` 'active' | 'suspended' | 'closing' | 'closed', required - BusinessCustomer - `address` Address, required - `city` string, required: City or locality. - `country_code` string, required: ISO 3166-1 alpha-2 country code. - `district_county` string, nullable, required: District or county. - `line1` string, required: Primary street address line. - `line2` string, nullable, required: Additional street address line. - `line3` string, nullable, required: Further street address line. - `postal_code` string, required: Postal code. - `created_at` string, date-time, required: The timestamp (in [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html) format) of when the resource was created. - `customer_type` 'business', required: Customer classification. - `entity_name` string, required: Registered business name. - `entity_type` string, nullable, required: Legal form of the business. - `full_name` string, required: Customer's full display name. - `id` string, required: Unique resource identifier. - `lei_code` string, nullable, required: Legal Entity Identifier. - `lei_code_expiry_date` string, date, nullable, required: Expiry date of the Legal Entity Identifier. - `mifid_category` string, nullable, required: Customer's MiFID classification. - `modified_at` string, date-time, required: The timestamp (in [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html) format) of when the resource was last modified. - `onboarding` string, nullable, required: ID of the customer's onboarding process. - `operating_address` Address, required - `city` string, required: City or locality. - `country_code` string, required: ISO 3166-1 alpha-2 country code. - `district_county` string, nullable, required: District or county. - `line1` string, required: Primary street address line. - `line2` string, nullable, required: Additional street address line. - `line3` string, nullable, required: Further street address line. - `postal_code` string, required: Postal code. - `phone_number` string, nullable, required: Customer's primary phone number. - `reference` string, nullable, required: Customer-visible reference. - `referrer_code` string, nullable, required: Referral code associated with the customer. - `risk_profile` string, nullable, required: Customer's assigned risk profile. - `risk_score` string, nullable, required: Customer's risk score. - `status` 'active' | 'suspended' | 'closing' | 'closed', required - `id` string, required: Unique resource identifier. - `is_primary` boolean, required: Whether this is the customer's primary account ownership. - `modified_at` string, date-time, required: The timestamp (in [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html) format) of when the resource was last modified. ## Other responses - `400`: Bad Request ## Changes - **2026-10-29** `6a63920239d8`: 2 breaking, 21 info - added `#/components/schemas/IndividualCustomer, #/components/schemas/JointCustomer, #/components/schemas/BusinessCustomer` to the `items/customer` response property `oneOf` list for the response status `200` - the `items/account` response's property type changed from no type to `object` for status `200` - removed `#/components/schemas/Account` from the `items/account` response property `allOf` list for the response status `200` - removed `#/components/schemas/IndividualCustomer, #/components/schemas/JointCustomer, #/components/schemas/BusinessCustomer` from the `items/customer` response property `anyOf` list for the response status `200` - …19 more - **2026-10-06** `aa43bab6253c`: 1 breaking - response property `context/additionalProperties/` list-of-types was widened by adding types `array` to media type `application/json` of response `400` - **2026-09-01** `0def92bc65f5`: 3 info - added `#/components/schemas/IndividualCustomer, #/components/schemas/JointCustomer, #/components/schemas/BusinessCustomer` to the `items/customer` response property `anyOf` list for the response status `200` - removed discriminator from `items/customer` response property for the response status `200` - removed `#/components/schemas/IndividualCustomer, #/components/schemas/JointCustomer, #/components/schemas/BusinessCustomer` from the `items/customer` response property `oneOf` list for the response status `200` - …earlier changes not shown [Operation history](https://skmtc.dev/joinsophic/apis/sophic-engine-api/changes/customers/:id/account-ownerships/get.md) --- [API](https://skmtc.dev/joinsophic/apis/sophic-engine-api.md) - [All operations](https://skmtc.dev/joinsophic/apis/sophic-engine-api/llms.txt) - [OpenAPI document](https://skmtc.dev/joinsophic/apis/sophic-engine-api/revisions/1afda7d8d185?raw)