---
title: "Get Portfolio by ID"
method: GET
path: "/v1/rebalancing/portfolios/{portfolio_id}"
tags: ["Rebalancing"]
---

# Get Portfolio by ID

`GET /v1/rebalancing/portfolios/{portfolio_id}`

## Request

- Base URL: `https://broker-api.giftcity.sandbox.in.alpaca.markets`
- URL: `https://broker-api.giftcity.sandbox.in.alpaca.markets/v1/rebalancing/portfolios/{portfolio_id}`
- Auth: HTTP basic

Get a portfolio by its ID.

## Response `200`

OK

- 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, required: Percentage allocated to this weight as a decimal string.
    - `symbol` string, nullable, required: Asset symbol. `null` for cash weights. Always present.
    - `type` 'cash' | 'asset', required: Type of weight entry in a portfolio.

## Other responses

- `401`: The request is not authenticated. Send a valid API key ID and secret, or a Broker Dashboard session, and try again.
- `403`: These credentials are not allowed to call this endpoint, or rebalancing is not enabled for the correspondent. Use credentials with the required permission and try again.
- `404`: No portfolio with this ID exists for your correspondent. Check the portfolio ID and try again.
- `422`: The request failed validation or cannot be completed in its current state. The message describes the reason.
- `500`: Something went wrong on our side while handling the request. Retry with backoff. If it keeps happening, contact support.

---

[API](https://skmtc.dev/alpacahq/apis/broker-api.md) - [All operations](https://skmtc.dev/alpacahq/apis/broker-api/llms.txt) - [OpenAPI document](https://skmtc.dev/alpacahq/apis/broker-api/revisions/381b1ecb3ccc?raw)