---
title: "List Portfolios"
method: GET
path: "/v1/rebalancing/portfolios"
tags: ["Rebalancing"]
---

# List Portfolios

`GET /v1/rebalancing/portfolios`

Lists portfolios.

When more than one query parameter is passed, only portfolios meeting all provided values will be returned (logical AND between parameter values).

## Query parameters

- `name` string
- `description` string
- `symbol` string
- `portfolio_id` string
- `status` 'active' | 'inactive' | 'needs_adjustment'

## Response `200`

Array of Portfolios

- Portfolio[]
  - `cooldown_days` integer, required — Count of calendar days following a rebalance before a subscription is eligible to trigger another rebalance
  - `created_at` string — Portfolio creation timestamp
  - `description` string — Text to describe portfolio
  - `id` string — Portfolio ID
  - `name` string — Name of portfolio
  - `rebalancing_conditions` string — Rebalancing conditions for portfolio
  - `status` 'active' | 'inactive' | 'needs_adjustment' — Current status of portfolio
  - `updated_at` string — Portfolio updated timestamp
  - `weights` PortfolioWeights[] — Weight configuration to portfolio. Sum of "percent" values in the weights array must be 100.00
    - `percent` string — Must be a positive value, up to two decimal places
    - `symbol` string — Must be fractionable asset. Only provided if type = "asset"
    - `type` string — Possible values of cash or asset

---

[API](https://skmtc.net/alpacahq/apis/gift-city-extensions-api.md) · [All operations](https://skmtc.net/alpacahq/apis/gift-city-extensions-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alpacahq/gift-city-extensions-api/revisions/62e3378bb273/schema)