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

const response = await fetch('https://api.bota.dev/v1/devices/dev_abc123/state', {
  headers: {
    'Authorization': 'Bearer sk_live_...',
  },
});

const state = await response.json();
const isOnline = state.last_heartbeat_at &&
  Date.now() - new Date(state.last_heartbeat_at).getTime() < 15 * 60 * 1000;
const isRecording = state.recording_state?.device_state === 'recording';

import requests
from datetime import datetime, timezone

response = requests.get(
    'https://api.bota.dev/v1/devices/dev_abc123/state',
    headers={'Authorization': 'Bearer sk_live_...'},
)

state = response.json()
last_hb = state.get('last_heartbeat_at')
is_online = (
    last_hb is not None
    and (datetime.now(timezone.utc) - datetime.fromisoformat(last_hb.replace('Z', '+00:00'))).total_seconds() < 900
)
is_recording = (state.get('recording_state') or {}).get('device_state') == 'recording'

{
  "device_id": "dev_abc123",
  "recording_state": {
    "device_state": "recording",
    "recording_id": "rec_xyz789",
    "started_at": "2025-01-20T10:30:00Z",
    "initiated_by": "remote",
    "pending_recordings": 2,
    "flags": 24,
    "wifi_status": "connected",
    "wifi_ssid": "office-wifi",
    "lte_status": "off",
    "connection_type": ["wifi"]
  },
  "battery_percent": 85,
  "storage_used_mb": 256,
  "storage_total_mb": 1024,
  "last_heartbeat_at": "2025-01-20T10:35:00Z",
  "last_synced_at": "2025-01-20T09:50:00Z",
  "last_seen_by": "wifi",
  "last_synced_by": "wifi"
}

{
  "device_id": "dev_abc123",
  "recording_state": {
    "device_state": "idle",
    "pending_recordings": 0,
    "flags": 8,
    "wifi_status": "connected",
    "lte_status": "off",
    "connection_type": ["wifi"]
  },
  "battery_percent": 92,
  "storage_used_mb": 128,
  "storage_total_mb": 1024,
  "last_heartbeat_at": "2025-01-20T10:35:00Z",
  "last_synced_at": null,
  "last_seen_by": "wifi",
  "last_synced_by": null
}

{
  "device_id": "dev_abc123",
  "recording_state": {
    "device_state": "idle",
    "pending_recordings": 0,
    "flags": 0
  },
  "battery_percent": 60,
  "storage_used_mb": 100,
  "storage_total_mb": 1024,
  "last_heartbeat_at": "2025-01-19T15:20:00Z",
  "last_synced_at": null,
  "last_seen_by": "wifi",
  "last_synced_by": null
}

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