---
title: "Portfolios colleagues shared with your organization, with what you may do with each and who shared it. Unpriced, like your own list; fetch one by id to have it valued."
method: GET
path: "/v1/portfolios/shared"
tags: ["Portfolios"]
---

# Portfolios colleagues shared with your organization, with what you may do with each and who shared it. Unpriced, like your own list; fetch one by id to have it valued.

`GET /v1/portfolios/shared`

## Request

- Base URL: `https://api.equibles.com`
- URL: `https://api.equibles.com/v1/portfolios/shared`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/equibles/apis/equibles-api/docs/v1/portfolios/shared/get.ts> (a function with typed inputs; its response is checked against the schema)

## Response `200`

OK

- PortfolioSummaryDtoListResponse
  - `listingNotice` ListingNotice: What happened to a requested ticker that no longer trades. "delisted": the company has no current US listing, so the answer is its history. "renamed": the company now trades as successorTicker, its current US presentation ticker (possibly another share class). A listed series (short volume, short interest, off-exchange volume, fails-to-deliver, congressional trades) is the retired ticker's own; a company-level read is the company's data.
    - `status` string, nullable: "delisted" or "renamed".
    - `ticker` string, nullable: The retired ticker as listed.
    - `delistedOn` string, date, nullable: The day the retired listing stopped trading, when known.
    - `successorTicker` string, nullable: For "renamed", the company's current US presentation ticker; null for "delisted".
  - `data` PortfolioSummaryDto[], nullable
    - `id` string, uuid
    - `name` string, nullable
    - `currency` string, nullable: ISO 4217 code the portfolio's totals are reported in.
    - `openLotCount` integer
    - `closedLotCount` integer
    - `createdAtUtc` string, date-time
    - `access` string, nullable: What you may do with it: Owner, Edit (change its lots and watches) or View.
    - `sharedBy` string, nullable: Who shared it with your organization. Absent on your own portfolios.

## Other responses

- `400`: Invalid request — a malformed parameter value or a query parameter this endpoint does not support.

---

[API](https://skmtc.dev/equibles/apis/equibles-api.md) - [All operations](https://skmtc.dev/equibles/apis/equibles-api/llms.txt) - [OpenAPI document](https://skmtc.dev/equibles/apis/equibles-api/revisions/666e06778588?raw)