# A unit

> `GET /batteries/{batteryId}` · Scope: `read` · operationId `getBattery`

Any member.

## Pfad-Parameter

- **batteryId** `string (uuid)` (erforderlich)

## Antworten

### 200 (`application/json`)

The unit.

- **battery_model_id** `string (uuid)` (erforderlich)
- **battery_status** `string` (erforderlich, einer von: `original`, `repurposed`, `reused`, `remanufactured`, `waste`)
- **created_at** `string (date-time)` (erforderlich)
- **facility_id** `string (uuid)`
- **id** `string (uuid)` (erforderlich)
- **identifiers_locked_at** `string (date-time)`: Set when the identifiers were locked (pre-print) or first published; serial and model are fixed afterwards.
- **import_id** `string (uuid)`: The import that created the unit.
- **manufacturing_date** `string (date)`
- **model_version_id** `string (uuid)` (erforderlich)
- **passport_status** `string` (erforderlich, einer von: `draft`, `qr_locked`, `published`, `update_needed`, `suspended`, `withdrawn`, `deleted_recycled`): Status of a unit's passport (`docs/domain-model.md` §7).
- **predecessor_battery_id** `string (uuid)`: Second life: the unit this battery was repurposed, reused or remanufactured from.
- **putting_into_service** `string (date)`
- **row_version** `integer (int64)` (erforderlich): Optimistic-concurrency version; send it back as `If-Match` when updating.
- **serial_number** `string` (erforderlich)
- **successor_battery_ids** `string (uuid)[]`: Second life: the units made from this battery.
- **updated_at** `string (date-time)` (erforderlich)

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

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

The resource does not exist in the organisation of the API key, or the public passport is unknown (`not_found`).

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

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

## Beispiel

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