---
title: "List stocks"
method: GET
path: "/v3/aggregation/stocks"
tags: ["Stocks"]
---

# List stocks

`GET /v3/aggregation/stocks`

Return a user's list of provider stocks.

## Query parameters

- `limit` number
- `since` string, date-time
- `account_id` number

## Response `200`

List stocks

- object — Represent paginated collection of resources.
  - `resources` Stock[]
    - `id` number — Stock's unique identifier
    - `account_id` number — Stock's linked account
    - `label` string — Stock's label
    - `ticker` string — Stock 4 characters identifier
    - `marketplace` string — Marketplace where the stock is traded
    - `isin` string — Stock's ISIN [ISO 6166] (see https://en.wikipedia.org/wiki/ISO_6166)
    - `stock_key` string — Stock identification key
    - `current_price` number — Current unitary price for one stock
    - `currency_code` string — 3 letters ISO 4217 currency code
    - `quantity` number — Quantity of stocks owned
    - `total_value` number — Total value of this stock's portfolio = `current_price` * quantity
    - `average_purchase_price` number — Average stock purchase price
    - `value_date` string, date — The date at which the `current_price` value was recorded
    - `deleted` boolean — Flag to indicate that the stock was deleted
    - `created_at` string, date-time — Timestamp recording when the stock was created
    - `updated_at` string, date-time — Timestamp recording when the stock was last refreshed
  - `pagination` object
    - `next_uri` string, nullable

## Other responses

- `401` — Error 401

---

[API](https://skmtc.dev/bridgeapi/apis/bridge-api.md) · [All operations](https://skmtc.dev/bridgeapi/apis/bridge-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bridgeapi/bridge-api/revisions/9b9ad8010fd5/schema)