Fixtures#

All properties described below relating to a fixture or device’s status are obtained by the Status Monitor.

Fixtures Overview#

Get an overview of fixtures used in the current project including their statuses.

GET /api/fixtures

Returns a JSON array of objects with the following attributes:

Attribute	Value Type	Description	Value Example
`groups`	array of strings	Names of groups containing this fixture	`["1 All Exterior"]`
`manufacturer`	string	Manufacturer name as defined in the fixture library	`"Generic"`
`number`	integer	User number of the fixture	`1`
`patch`	string	Combined universe key and address (see Universe Key String Format)	`"dmx:2:101"`
`protocol`	string	`"dali"`, or `"dmx"`	`"dmx"`
`status`	string	`"online"`, `"partially_offline"`, `"offline"`, `"loading"`, or `"unknown"`	`"online"`
`updated_at`	string	ISO 8601-formatted timestamp of the last status update, or `null` if unknown	`2024-06-27T09:30`

Get detailed information for a single fixture including its status.

GET /api/fixtures/{fixtureNumber}

Returns a JSON object extending the Fixtures Overview GET response with the following additional attributes:

Attribute	Value Type	Description	Value Example
`type`	string	Fixture type as defined in the fixture library	`LED - RGBW 8 bit`
`rdm_device_uids`	array of strings	The UIDs of any RDM devices associated with this fixture	`["1234:56789abc"]`
`custom_properties`	object	Object properties and property values correspond to custom property names and values	`{ "Custom Property 1": "value" }`

A universe key string takes the form:

protocol:index for protocols dmx, pathport, sacn, art-net;
protocol:kinetPowerSupplyNum:kinetPort for protocol kinet;
protocol:remoteDeviceType:remoteDeviceNum for protocol rio-dmx;
protocol:remoteDeviceType:remoteDeviceNum:port for protocols edn, edn-spi.

Where:

For example: