---
title: "List Securities Accounts"
method: GET
path: "/accounts/{account_id}/securities_accounts"
tags: ["Securities Accounts"]
---

# List Securities Accounts

`GET /accounts/{account_id}/securities_accounts`

## Request

- Base URL: `https://sandbox.api.lemon.markets/v1`
- URL: `https://sandbox.api.lemon.markets/v1/accounts/{account_id}/securities_accounts`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api/docs/accounts/:account_id/securities_accounts/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `account_id` string, required

## Query parameters

- `cursor` string
- `limit` integer
- `status` 'created' | 'opened' | 'rejected' | 'closed'

## Headers

- `LMG-Data-Privacy-Access-Principal` string, required
- `LMG-Data-Privacy-Access-Justification` string, required

## Response `200`

Successful Response

- EncodedPaginatedCollectionResponseSecuritiesAccountResponse
  - `data` BrokerAppsApiEndpointsSecuritiesAccountsSecuritiesAccountResponse[], required: The elements of the response.
    - `id` string, required: A value identifiying a securities account. Use this as a technical identifier for the securities account.
    - `account_number` string, required: A string representing the account number for the securities account. Use this is a user-visible identifier for the securities account.
    - `cash_account` string, nullable: The identifier of the cash account mapped to this securities account, used to retrieve its details via `GET /accounts/{account_id}/cash_accounts/{cash_account_id}`. `null` when no cash account is mapped.
    - `product` string: The identifier of the product the securities account belongs to, used to retrieve its details via `GET /accounts/{account_id}/products/{id}`. `null` when the securities account does not belong to a product.
    - `history` StatusChangeCustomerAccountStatus[], required: A history of the status changes for the security account.
      - `status` 'closed' | 'created' | 'opened' | 'rejected', required: A category representing the status of a user's account. <ul> <li><code>closed</code> <li><code>created</code> <li><code>opened</code> <li><code>rejected</code> </ul> <strong>NOTE:</strong> This list is not final yet, there will be more values added later.
      - `timestamp` string, date-time, required: The timestamp of the event. It represents the point in time at which the account was updated.
  - `pagination` EncodedPaginationResponse, required: Information about accessing elements beyond the ones that were returned.
    - `next_cursor` string: When fetching long lists of elements, you can use our pagination feature to fetch batches of data. If a response contains the property `pagination.next_cursor`, you can pass its value via the query item `cursor` to generate the request for the next batch of data.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `404`: Not Found
- `422`: Unprocessable Entity
- `5XX`: Server Error

## Changes

- **2026-11-03** `1f1df208c0e4`: 2 info
  - added the optional property `data/items/cash_account` to the response with the `200` status
  - added the optional property `data/items/product` to the response with the `200` status

[Operation history](https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api/changes/accounts/:account_id/securities_accounts/get.md)

---

[API](https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api.md) - [All operations](https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api/revisions/1f1df208c0e4?raw)
