> ## Documentation Index
> Fetch the complete documentation index at: https://docs.silicondata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GPU Index API

> API docs for accessing GPU Index from Silicon Data.

> 📌 **Note:** The GPU Index API is only available for **Plus** and **Professional** tier subscribers. Access is further gated per subscription: your subscription may restrict the available `index_version` (`hs` / `neo`) and the queryable date range.

## <span style={{ color: 'white', fontWeight: 'bold', backgroundColor: '#007BFF', border: '2px solid #007BFF', borderRadius: '5px', padding: '5px', display: 'inline-block' }}>POST</span> /api/gpu-index/index

Get GPU index data, from starting date (from 2024-09-01) to ending date. If no date range is provided, data for today will be used by default. A returned value of `-1` or any negative number indicates that the data has not yet been generated—please wait or contact support.

### Authorization

**🔒OAuth2**: OAuth2PasswordBearer\
**Flow type**: password\
**Token URL**: token

### Request Body

The request body must be in `application/json` format.

| Field           | Type           | Required | Description                                                                                                                   | Constraints                                                                    |
| --------------- | -------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
| `gpu`           | string         | YES      | GPU type to query (case-insensitive).                                                                                         | One of `h100`, `a100`, `b200`, `mi300x`, `h200`; 1 to 20 characters            |
| `index_version` | string         | NO       | Index version: `neo` (NeoCloud) or `hs` (HyperScaler). Defaults to `neo`. May be overridden by your subscription permissions. | One of `hs`, `neo`                                                             |
| `starting_date` | string or null | NO       | The start date for the query in `YYYY-MM-DD` format. Defaults to today if not provided.                                       | On or after the per-GPU minimum date (default `2024-09-01`); not in the future |
| `ending_date`   | string or null | NO       | The end date for the query in `YYYY-MM-DD` format. Defaults to today if not provided.                                         | Not in the future                                                              |

`starting_date` must be less than or equal to `ending_date`.

### Request Example

```json theme={null}
{
  "gpu": "h100",
  "index_version": "neo",
  "starting_date": "2025-04-01",
  "ending_date": "2025-04-05"
}
```

### Responses

* **200**: Successful Response

  Index values are returned as strings formatted to two decimal places. The `index_version` field is only included when your subscription grants access to an `hs`/`neo` catalog.

```json theme={null}
{
    "meta": {
        "code": 0,
        "url": "/api/gpu-index/index",
        "message": "OK",
        "timestamp": 1744201871
    },
    "data": {
        "gpu": "h100",
        "starting_date": "2025-04-01",
        "ending_date": "2025-04-05",
        "indexes": {
            "2025-04-01": "2.25",
            "2025-04-02": "2.22",
            "2025-04-03": "2.27",
            "2025-04-04": "2.26",
            "2025-04-05": "2.33"
        },
        "index_version": "neo"
    }
}
```

* **422**: Validation Error

```json theme={null}
{
  "detail": [
    {
      "loc": [
        "string"
        ],
        "msg": "string",
        "type": "string"
    }
  ]
}
```

* **10008**: Parameter limit error (e.g. `starting_date` after `ending_date`, a date in the future, or an unsupported `gpu` type)

```json theme={null}
{
    "meta": {
        "code": 10008,
        "url": "/api/gpu-index/index",
        "message": "starting date should be less than or equal to ending date",
        "timestamp": 1744289950,
        "args": [],
        "kwargs": {}
    },
    "data": {}
}
```

* **404**: Subscription not found

```json theme={null}
{
    "meta": {
        "code": 404,
        "url": "/api/gpu-index",
        "message": "404, Not Found",
        "timestamp": 1744289950,
        "args": [],
        "kwargs": {}
    },
    "data": {}
}
```