# List runner labels (/api/labels/get-labels)

`GET /api/labels`

The catalog of available runner labels with their specs (cpu, memory, arch, price/min) so runs-on mapping and cost-savings hints reference concrete options. Static and identical for every caller — authenticated, but requires no resource scope.

Base URL: `https://runners.starsling.dev`

## Authentication

Requires a bearer token (`Authorization: Bearer`).

## Responses

| Status | Description |
| --- | --- |
| `200` | Every runner label `runs-on` accepts, with its specs and price. |
| `401` | No credential was sent, or the one sent is expired or revoked. Sign in with `sling login`. |
| `500` | The request was valid; the control plane or a dependency it calls failed. |

### `200` body

- `labels` — array<object>, required
  - array of object
    - `label` — string, required. e.g. `starsling-ubuntu-24.04-8`
    - `cpu` — number, required. e.g. `8`
    - `memory_gb` — number, required. e.g. `32`
    - `arch` — string, required. e.g. `x64`
    - `price_per_min_usd` — number, required. e.g. `0.016`

### Example

```json
{
  "labels": [
    {
      "label": "starsling-ubuntu-24.04-8",
      "cpu": 8,
      "memory_gb": 32,
      "arch": "x64",
      "price_per_min_usd": 0.016
    }
  ]
}
```