---
title: "Discover smallcases"
method: GET
path: "/{gatewayname}/engine/smallcases"
---

# Discover smallcases

`GET /{gatewayname}/engine/smallcases`

## Request

- Base URL: `https://gatewayapi.smallcase.com/v1`
- URL: `https://gatewayapi.smallcase.com/v1/{gatewayname}/engine/smallcases`
- Auth: none required

The API provides list of all smallcases enabled for your gateway. Data like smallcase info, return stats, benchmark info is shared.

**<<apiUseCaseTerm>>**: This is ideal data API when you want to display list of available smallcases to user.

## Path parameters

- `gatewayname` string, required

## Query parameters

- `sortBy` string
- `sortOrder` integer
- `count` integer
- `offset` integer
- `showBlocked` boolean
- `showPlayedOut` boolean

## Headers

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

## Response `200`

200

- object
  - `success` boolean
  - `errors` unknown
  - `data` object
    - `smallcases` object[]
      - `_id` string
      - `info` object
        - `created` string
        - `uploaded` string
        - `name` string
        - `shortDescription` string
        - `type` string
        - `publisherName` string
        - `blogURL` unknown
        - `nextUpdate` string
        - `rebalanceSchedule` string
        - `lastRebalanced` string
        - `imageUrl` string
      - `stats` object
        - `returns` object
          - `daily` number
          - `weekly` number
          - `monthly` number
          - `quarterly` number
          - `halfyearly` number
          - `yearly` number
          - `threeYear` number
          - `fiveYear` number
          - `sinceInception` number
          - `sinceLaunch` integer
        - `indexValue` number
        - `unadjustedIndex` number
        - `divReturns` number
        - `lastCloseIndex` number
        - `minInvestAmount` integer
        - `ratios` object
          - `cagr` number
          - `momentumRank` integer
          - `risk` number
          - `sharpe` number
          - `52wHigh` number
          - `52wLow` number
          - `divYield` number
          - `divYieldDifferential` number
          - `largeCapPercentage` number
          - `marketCapCategory` string
          - `midCapPercentage` integer
          - `pb` number
          - `pbDiscount` number
          - `pe` number
          - `peDiscount` number
          - `smallCapPercentage` number
          - `ema` number
          - `momentum` number
          - `lastCloseEma` number
          - `sharpeRatio` number
          - `riskLabel` string
          - `oneYearLiveHistory` boolean
          - `cagrDuration` string
        - `minSipAmount` integer
        - `minInvestAmountOverridden` boolean
        - `recommendedBuyAmount` integer
        - `launchDateIndex` integer
      - `version` integer
      - `scid` string
      - `rationale` string
      - `updates` object[]
        - `label` string
        - `rationale` string
        - `date` string
        - `version` integer
        - `appliedToUsers` boolean
        - `appliedToMofsl` boolean
        - `skipped` boolean
      - `benchmark` object
        - `id` string
        - `message` string
        - `index` string
        - `msg` string
      - `assetUniverse` string
      - `assetClass` string

---

[API](https://skmtc.dev/smallcase/apis/smallcase-data-v1.md) - [All operations](https://skmtc.dev/smallcase/apis/smallcase-data-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/smallcase/apis/smallcase-data-v1/revisions/9e1b64a1d830?raw)