> ## 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 Mark™ GPU Performance API

> API docs for listing individual GPU benchmark rows with scoreboard performance tiers from Silicon Data.

# GPU Performance API

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

List individual GPUs with scoreboard performance tiers. Returns paginated individual-GPU benchmark rows with server-derived Gaussian percentile tiers. In v1, scoreboard metrics are populated only when `benchmark_id` is `quick_mark`.

### Authorization

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

### Query Parameters

| Field          | Type    | Required | Description                                                    | Constraints                                 |
| -------------- | ------- | -------- | -------------------------------------------------------------- | ------------------------------------------- |
| `page`         | integer | No       | Page number                                                    | >= 1, default 1                             |
| `per_page`     | integer | No       | Items per page                                                 | \[ 1 .. 300 ], default 20                   |
| `benchmark_id` | string  | No       | Benchmark that drives scoreboard rows                          | default `quick_mark` (v1: use `quick_mark`) |
| `gpu_model`    | string  | No       | Filter by GPU model                                            |                                             |
| `status`       | string  | No       | Filter by Gaussian percentile tier                             | `optimal`, `acceptable`, `underperforming`  |
| `name`         | string  | No       | Substring filter on job name                                   |                                             |
| `tags`         | array   | No       | Filter by job tags (repeat for multiple; job must include all) |                                             |
| `state`        | string  | No       | Job state filter                                               | default `completed` when omitted            |

### Responses

* **200**: Successful Response

```json theme={null}
{
  "results": [
    {
      "id": "7554621441-0",
      "gpu_label": "GPU0",
      "gpu_id": "GPU-550e8400-e29b-41d4-a716-446655440000",
      "model": "NVIDIA A100-SXM4-80GB",
      "job_name": "GPU Benchmark Test",
      "node_name": "192.168.1.10",
      "fp16": 78.5,
      "fp32": 39.2,
      "memory_bandwidth": 1935.4,
      "percentile": 82.4,
      "status": "optimal"
    }
  ],
  "pagination": {
    "total": 32,
    "page": 1,
    "per_page": 20,
    "total_pages": 2,
    "has_next": true,
    "has_prev": false
  }
}
```