# List the battery models of the active organisation

> `GET /battery-models` · Scope: `read` · operationId `listBatteryModels`

Any member. Ordered by name, then id. Archived models only with `include_archived=true`.

## Query-Parameter

- **limit** `integer` (Standard: 50): Maximum number of items to return.
- **cursor** `string`: Opaque cursor from a previous page's `next_cursor`.
- **include_archived** `boolean` (Standard: false)

## Antworten

### 200 (`application/json`)

One page of battery models.

- **items** `BatteryModel[]` (erforderlich)
  - **archived_at** `string | null` (erforderlich)
  - **category** `string` (erforderlich, einer von: `ev`, `lmt`, `industrial`, `stationary`, `industrial_without_bms`): Battery category per Regulation (EU) 2023/1542; drives registry requirements.
  - **created_at** `string (date-time)` (erforderlich)
  - **gtin** `string | null` (erforderlich): GTIN-14 (normalised, check digit valid).
  - **id** `string (uuid)` (erforderlich)
  - **name** `string` (erforderlich)
  - **row_version** `integer (int64)` (erforderlich): Optimistic-concurrency version; send it back as `If-Match` when updating.
  - **sku** `string | null` (erforderlich)
  - **updated_at** `string (date-time)` (erforderlich)
- **next_cursor** `string | null` (erforderlich): Cursor for the next page, or null when this is the last page.

### 400 (`application/problem+json`)

The request is malformed or failed validation (`validation_error`), or a token is invalid or expired (`invalid_token`).

### 401 (`application/problem+json`)

The API key is missing, unknown or revoked (`unauthenticated`).

### 403 (`application/problem+json`)

The API key may not perform this action (`forbidden`): it lacks the operation's scope, or the action needs more than a viewer's rights.

### default (`application/problem+json`)

Any other problem, e.g. `internal_error`.

## Beispiel

```bash title="cURL"
curl -X GET "https://passport.kabin.sh/api/v1/battery-models" \
  -H "Authorization: Bearer $BATTERYPASS_API_KEY"
```