curl https://api.bota.dev/v1/devices/dev_abc123/ota \
  -H "Authorization: Bearer sk_live_..."

const { data: assignment } = await fetch(
  'https://api.bota.dev/v1/devices/dev_abc123/ota',
  { headers: { 'Authorization': 'Bearer sk_live_...' } },
).then((r) => r.json());

if (!assignment) {
  // Never assigned firmware.
} else if (assignment.status === 'applied') {
  // The update is installed.
} else if (assignment.status === 'pending' || assignment.status === 'delivered') {
  // Still in flight.
}

import requests

assignment = requests.get(
    'https://api.bota.dev/v1/devices/dev_abc123/ota',
    headers={'Authorization': 'Bearer sk_live_...'},
).json()['data']

if assignment is None:
    ...  # Never assigned firmware.
elif assignment['status'] == 'applied':
    ...  # The update is installed.

{
  "data": {
    "id": "ota_7Rp2XvB4nT6yL8cW1kQ9mZa3",
    "device_id": "dev_abc123",
    "firmware_release_id": "fw_3kQ9mZa7Rp2XvB4nT6yL8cW1",
    "status": "delivered",
    "assigned_at": "2026-08-14T12:00:00Z",
    "delivered_at": "2026-08-14T12:01:30Z",
    "applied_at": null,
    "error_message": null
  }
}

{
  "data": {
    "id": "ota_7Rp2XvB4nT6yL8cW1kQ9mZa3",
    "device_id": "dev_abc123",
    "firmware_release_id": "fw_3kQ9mZa7Rp2XvB4nT6yL8cW1",
    "status": "applied",
    "assigned_at": "2026-08-14T12:00:00Z",
    "delivered_at": "2026-08-14T12:01:30Z",
    "applied_at": "2026-08-14T12:06:12Z",
    "error_message": null
  }
}

{
  "data": null
}

{
  "error": {
    "code": "not_found",
    "message": "Device not found"
  }
}