API Endpoints

Complete reference of Night Owl Protect API endpoints.

Devices

List Devices

GET /v1/devices

Response:

{
  "data": [
    {
      "id": "dev_abc123",
      "name": "Front Door Camera",
      "type": "camera",
      "status": "online",
      "model": "NOP-4K-CAM"
    }
  ]
}

Get Device

GET /v1/devices/{device_id}

Control Device

POST /v1/devices/{device_id}/control

Body:

{
  "action": "reboot"
}

Recordings

List Recordings

GET /v1/devices/{device_id}/recordings

Query Parameters:

start_date - ISO 8601 date
end_date - ISO 8601 date
event_type - motion, human, vehicle

Get Recording

GET /v1/recordings/{recording_id}

Download Recording

GET /v1/recordings/{recording_id}/download

Alerts

List Alerts

GET /v1/alerts

Get Alert

GET /v1/alerts/{alert_id}

Mark as Read

POST /v1/alerts/{alert_id}/read

Live Stream

Get Stream URL

GET /v1/devices/{device_id}/stream

Response:

{
  "stream_url": "rtsp://...",
  "expires_at": "2024-01-15T12:00:00Z"
}

For complete documentation, visit developers.nightowlsp.com.