---
title: "Fetch User Portfolio Breakdown"
method: GET
path: "/api/portfolio/breakdown"
tags: ["Portfolio Reporting"]
---

# Fetch User Portfolio Breakdown

`GET /api/portfolio/breakdown`

## Request

- Base URL: `https://powered-by-bamboo-sandbox.investbamboo.com`
- URL: `https://powered-by-bamboo-sandbox.investbamboo.com/api/portfolio/breakdown`
- Auth: none declared. Required headers: `content-type`, `accept-language`, `x-user-id`, `x-subject-type`, `x-client-token`

This endpoint provides information about the user's good faith violation status, account restrictions, money available for investment or withdrawal, and overall investment performance metrics.

##### Advanced portfolio analytics include:
- **Good faith violations:** showing trading rule violation count and impact
- **Available to invest:** Exact buying power for new trades
- **Withdrawable cash:** showing funds eligible for withdrawal
- **Total return analysis:** with comprehensive performance metrics
- **Equity Value:** Current value of all stock holdings

Risk management information covers day trading restrictions based on account equity levels, violation tracking for pattern day trader rule compliance, and overall account health status.

## Headers

- `content-type` string, required
- `accept-language` string, required
- `x-user-id` string, required
- `x-subject-type` string, required
- `currency` string
- `x-client-token` string, required

## Response `200`

Portfolio breakdown

- PortfolioBreakdownResponse
  - `withdrawable_cash` number, required: Maximum amount that can be withdrawn
  - `value` number, required: Value of portfolio
  - `total_return` number, required: Total return
  - `total_percent_change` number, required: Total portfolio change
  - `total_invested` number, required: Total invested
  - `total_aum` number, required: Total AUM
  - `restricted_by_dw` boolean, required: Restricted by DW
  - `number_of_violations` number, required: Number of GFV for account
  - `equity_value` number, required: Equity value
  - `currency_symbol` string, required: Prices currency symbol
  - `base_wallet_balance` number, required: Base wallet Balance
  - `available_to_invest` number, required: Buying power

## Other responses

- `401`: Token have expired or invalid token
- `404`: Resource not found
- `422`: Error response

---

[API](https://skmtc.dev/investbamboo/apis/investbamboo-bamboo-api.md) - [All operations](https://skmtc.dev/investbamboo/apis/investbamboo-bamboo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/investbamboo/apis/investbamboo-bamboo-api/revisions/063521e8d924?raw)