---
title: "Read Active Farm Devices"
method: GET
path: "/api/v1/customer/farms/{farm_id}/devices"
tags: ["customer farm assignments"]
---

# Read Active Farm Devices

`GET /api/v1/customer/farms/{farm_id}/devices`

## Request

- Base URL: `https://api.brumby.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.brumby.com/api/v1/customer/farms/{farm_id}/devices`
- Auth: none declared

## Path parameters

- `farm_id` string, required

## Response `200`

Successful Response

- FarmDeviceAssignmentsResponse: Active devices for one opaque external farm identifier.
  - `farm_id` string, required
  - `devices` FarmAssignedDeviceResponse[], required
    - `device_id` string, required
    - `display_name` string, nullable, required
    - `hardware_kind` 'n100' | 'jetson', required
    - `lifecycle` 'inventory' | 'commissioned' | 'active' | 'maintenance' | 'retired', required
    - `availability` 'online' | 'offline', required
    - `health_status` 'healthy' | 'degraded' | 'unknown', required
    - `last_seen_at` string, date-time, nullable, required
    - `assigned_at` string, date-time, required
    - `software_version` string, nullable, required
    - `bundle` FarmDeviceBundleResponse: Bundle facts for this installed pair; never a farm-wide version.
      - `binding_state` 'bound' | 'unbound' | 'not_applicable', required
      - `system` object, nullable
      - `managed` boolean
      - `last_verified_bundle_release_id` string, uuid, nullable
      - `last_verified_bundle` object, nullable
      - `desired_bundle` object, nullable
      - `deployment` object, nullable
      - `current_match` string
      - `current_match_detail` object, nullable
      - `observed_components` object
  - `generated_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/brumby/apis/brumby-platform-api.md) - [All operations](https://skmtc.dev/brumby/apis/brumby-platform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/brumby/apis/brumby-platform-api/revisions/fe185e20813e?raw)