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

# Silicon navigator

## <span style={{ color: 'white', fontWeight: 'bold', backgroundColor: '#28A745', border: '2px solid #28A745', borderRadius: '5px', padding: '5px', display: 'inline-block' }}>GET</span> /api/silicon-navigator/gpu-list

Get the list of GPUs available in SiliconNavigator.

### Authorization

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

### Responses

* **200**: Successful Response

```json theme={null}
{
    "meta": {
        "code": 0,
        "url": "/api/silicon-navigator/gpu-list",
        "message": "OK",
        "timestamp": 1744201871
    },
    "data": {
        "total": 2,
        "results": [
            {
                "id": 1,
                "name": "NVIDIA H100 SXM",
                "slug": "nvidia-h100-sxm"
            },
            {
                "id": 2,
                "name": "NVIDIA A100 PCIe 80 GB",
                "slug": "nvidia-a100-pcie-80-gb"
            }
        ]
    }
}
```

***

## <span style={{ color: 'white', fontWeight: 'bold', backgroundColor: '#28A745', border: '2px solid #28A745', borderRadius: '5px', padding: '5px', display: 'inline-block' }}>GET</span> /api/silicon-navigator/gpu-specs/params

Get the available filter parameters (distinct manufacturers and chips) for the GPU specs query.

### Authorization

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

### Responses

* **200**: Successful Response

```json theme={null}
{
    "meta": {
        "code": 0,
        "url": "/api/silicon-navigator/gpu-specs/params",
        "message": "OK",
        "timestamp": 1744201871
    },
    "data": {
        "manufacturer_list": [
            "AMD",
            "NVIDIA"
        ],
        "chip_list": [
            "A100",
            "H100",
            "MI300X"
        ]
    }
}
```

***

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

Get the GPU specs list, with optional filtering, ordering, and pagination.

### Authorization

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

### Request Body

The request body must be in `application/json` format. All fields are optional; an empty body returns the first page of results ordered by `retail_price desc`.

| Field      | Type   | Required | Description                                                                                                                                                                                                         | Constraints                                                                                                                                                        |
| ---------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `filter`   | array  | No       | List of filter conditions. Each item is an object with exactly one `{ "column": "value" }` pair. String columns match by case-insensitive substring; numeric columns accept an exact value or a `"low-high"` range. | Allowed columns: `name`, `slug`, `bus`, `manufacturer`, `chip`, `mem`, `mem_bus`, `bandwidth`, `fp16`, `tdp`, `msrp`, `retail_price`, `rental_price`, `cpp`, `ppw` |
| `order_by` | array  | No       | List of order-by conditions. Each item is an object with exactly one `{ "column": "asc" \| "desc" }` pair. Defaults to `retail_price desc`.                                                                         | Direction must be `asc` or `desc`; columns as in `filter`                                                                                                          |
| `paginate` | object | No       | Pagination object with `num_per_page` and `page_num`.                                                                                                                                                               | `num_per_page`: \[ 1 .. 100 ], default 50; `page_num`: >= 1, default 1                                                                                             |

### Request Example

```json theme={null}
{
  "filter": [
    { "manufacturer": "NVIDIA" },
    { "mem": "80-141" }
  ],
  "order_by": [
    { "retail_price": "desc" }
  ],
  "paginate": {
    "num_per_page": 50,
    "page_num": 1
  }
}
```

### Responses

* **200**: Successful Response

```json theme={null}
{
    "meta": {
        "code": 0,
        "url": "/api/silicon-navigator/gpu-specs",
        "message": "OK",
        "timestamp": 1744201871
    },
    "data": {
        "total": 1,
        "results": [
            {
                "id": 1,
                "name": "NVIDIA H100 SXM",
                "slug": "nvidia-h100-sxm",
                "manufacturer": "NVIDIA",
                "chip": "H100",
                "bus": "SXM5",
                "mem": 80,
                "mem_bus": 5120,
                "bandwidth": 3350,
                "fp16": 1979,
                "tdp": 700,
                "msrp": 30000,
                "retail_price": 28500,
                "rental_price": 2.25,
                "released_date": "2022-03-22"
            }
        ]
    }
}
```

* **422**: Validation Error

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