Feeder Status

GET /api/v1/feeders/status

Returns a list of all feeders across your authorized networks. Feeders are hardware units that feed video/data into the platform, associated with a device.

Query parameters

Parameter	Type	Required	Description
site_id	integer or integer[]	No	Filter by one or more site IDs
location_id	integer or integer[]	No	Filter by one or more location IDs

Response 200

{
  "status": true,
  "message": "Success",
  "data": {
    "count": 1,
    "rows": [
      {
        "id": 55,
        "name": "Main Entrance Feeder",
        "device": { "id": 101, "name": "Store Entrance Camera" },
        "network": { "id": 1, "name": "Retail Network A" },
        "site": { "id": 5, "name": "CBD Store" },
        "location": { "id": 12, "name": "Entrance" },
        "status": "online",
        "last_active_timestamp": "2026-03-30T04:10:00.000Z",
        "source": "heartbeat"
      }
    ]
  }
}

Status values

Same as device status: online / offline based on heartbeat status.

GET /api/v1/feeders/status/:id

Returns status for a single feeder by its ID.

Path parameters

Parameter	Type	Required	Description
id	integer	Yes	Feeder ID

Response 200

{
  "status": true,
  "message": "Success",
  "data": {
    "id": 55,
    "name": "Main Entrance Feeder",
    "device": { "id": 101, "name": "Store Entrance Camera" },
    "network": { "id": 1, "name": "Retail Network A" },
    "site": { "id": 5, "name": "CBD Store" },
    "location": { "id": 12, "name": "Entrance" },
    "status": "online",
    "last_active_timestamp": "2026-03-30T04:10:00.000Z",
    "source": "heartbeat"
  }
}

Errors

400 INVALID_PARAM, 403 FORBIDDEN_NETWORKS, 404 NOT_FOUND