---
title: "Fetch holdings"
method: GET
path: "/{gatewayname}/engine/user/holdings"
---

# Fetch holdings

`GET /{gatewayname}/engine/user/holdings`

Fetch holdings and positions using our Holdings Import feature.

## Path parameters

- `gatewayname` string, required

## Query parameters

- `version` string
- `mfHoldings` boolean

## Headers

- `x-gateway-secret` string, required
- `x-gateway-authtoken` string, required

## Response `200`

200

- union
  - object
    - `success` boolean
    - `errors` unknown
    - `data` object
      - `smallcases` object
        - `public` object[]
          - `scid` string
          - `name` string
          - `investmentDetailsURL` string
          - `shortDescription` string
          - `imageUrl` string
          - `stats` object
            - `currentValue` number
            - `totalReturns` number
          - `constituents` object[]
            - `ticker` string
            - `shares` integer
        - `private` object
          - `stats` object
            - `currentValue` number
            - `totalReturns` number
      - `securities` object[]
        - `holdings` object
          - `quantity` integer
          - `averagePrice` number
        - `positions` object
          - `nse` object
            - `quantity` integer
            - `averagePrice` number
          - `bse` object
            - `quantity` integer
            - `averagePrice` number
        - `transactableQuantity` integer
        - `smallcaseQuantity` integer
        - `nseTicker` string
        - `bseTicker` string
        - `isin` string
        - `name` string
      - `updating` boolean
      - `lastUpdate` string
      - `snapshotDate` string
      - `smallcaseAuthId` string
      - `broker` string
  - object
    - `success` boolean
    - `errors` unknown
    - `data` object
      - `smallcases` object
        - `public` object[]
          - `scid` string
          - `name` string
          - `investmentDetailsURL` string
          - `shortDescription` string
          - `imageUrl` string
          - `stats` object
            - `currentValue` number
            - `totalReturns` number
          - `constituents` object[]
            - `ticker` string
            - `shares` integer
        - `private` object[]
          - `scid` string
          - `name` string
          - `investmentDetailsURL` string
          - `shortDescription` string
          - `imageUrl` string
          - `stats` object
            - `currentValue` number
            - `totalReturns` number
      - `securities` object
        - `holdings` object[]
          - `ticker` string
          - `shares` integer
          - `name` string
          - `exchange` string
          - `averagePrice` integer
      - `updating` boolean
      - `lastUpdate` string
      - `snapshotDate` string
      - `mutualFunds` object
        - `holdings` object[]
          - `folio` string
          - `fund` string
          - `tradingsymbol` string
          - `pnl` number
          - `quantity` number
          - `isin` string
          - `averagePrice` number
          - `lastPriceDate` string
          - `lastPrice` number
          - `xirr` integer
      - `smallcaseAuthId` string
      - `broker` string

## Other responses

- `403` — 403

---

[API](https://skmtc.net/smallcase/apis/graph-performance-api.md) · [All operations](https://skmtc.net/smallcase/apis/graph-performance-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smallcase/graph-performance-api/versions/6d2439eafede/schema)