---
title: "Fetch User Ownership Details"
method: GET
path: "/api/stock/{stockSymbol}/ownership"
tags: ["Portfolio Reporting"]
---

# Fetch User Ownership Details

`GET /api/stock/{stockSymbol}/ownership`

## Request

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

This endpoint provides detailed ownership information about a specific stock that a user owns, including insights into portfolio performance since acquiring the stock.
##### Individual stock analysis covers:
  - Position size showing shares owned and current market value
  - Performance tracking with total return and daily return for the holding
  - Cost basis indicating average purchase price and total invested amount
  - Portfolio diversity percentage that this holding represents
  - Outstanding buy or sell orders for this stock
  
This data supports detailed stock performance analysis, portfolio rebalancing decisions, tax reporting and cost basis tracking, and individual position management.

## 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

- USOwnershipResponse
  - `currency_symbol` number, required: currency_symbol
  - `ownership` object, required: Value of portfolio
    - `shares` number: shares
    - `average_cost` number: average_cost
    - `equity` number: equity
    - `portfolio_diversity` number: portfolio_diversity
    - `todays_return` boolean: todays_return
    - `todays_return_percent` number: todays_return_percent
    - `total_return` number: total_return
    - `total_return_percent` string: total_return_percent
  - `pending_orders` string, required: pending_orders

## 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)