GET api/v1/bots/lifxbots
Get all LifxBots for the current account.
Request Information
URI Parameters
None.
Body Parameters
None.
Response Information
Resource Description
Collection of LifxBotDto| Name | Description | Type | Additional information |
|---|---|---|---|
| Lights | Collection of LifxLightDto |
None. |
|
| Id |
User Id |
globally unique identifier |
None. |
| Name |
The users name |
string |
None. |
| UserName |
UserName (used to login with) |
string |
None. |
| FullUserName |
User Id and Account name |
string |
None. |
| BotType |
The type of bot. |
string |
None. |
| DisplayName |
Users first and last name |
string |
None. |
| DevicesCheckIntervalMinutes |
How often the spark account should be checked for new devices. |
integer |
None. |
| MeasurementCollectionIntervalMinutes |
How often measurements should be collected from the devices (applies to new devices only). |
integer |
None. |
| Links |
Collection of links appropriate for the user |
Collection of LinkDto |
None. |
| Actions | Collection of LinkDto |
None. |
|
| Description | string |
None. |
|
| Enabled | boolean |
None. |
|
| Authenticated |
If the bot is authenticated. |
boolean |
None. |
Response Formats
application/json, text/json, application/senml+json
Sample:
[
{
"Lights": [
{
"LifxId": "sample string 1",
"Assigned": true,
"DeviceId": "19aade9a-beee-44fc-b6e2-9098feba725e",
"Name": "sample string 4",
"Power": "sample string 5",
"Connected": true,
"BrightnessPercentage": 7,
"GroupName": "sample string 8",
"LocationName": "sample string 9",
"Hue": 10.1,
"ColorTemperature": 11,
"Saturation": 12.1,
"ProductName": "sample string 13",
"LastSeen": "2025-10-23T09:44:42.0257768+00:00",
"Links": [],
"Actions": []
},
{
"LifxId": "sample string 1",
"Assigned": true,
"DeviceId": "19aade9a-beee-44fc-b6e2-9098feba725e",
"Name": "sample string 4",
"Power": "sample string 5",
"Connected": true,
"BrightnessPercentage": 7,
"GroupName": "sample string 8",
"LocationName": "sample string 9",
"Hue": 10.1,
"ColorTemperature": 11,
"Saturation": 12.1,
"ProductName": "sample string 13",
"LastSeen": "2025-10-23T09:44:42.0257768+00:00",
"Links": [],
"Actions": []
}
],
"Id": "96412fab-803e-46d8-bbca-24fd94f9e6ab",
"Name": "sample string 2",
"UserName": "sample string 3",
"FullUserName": "sample string 4",
"BotType": "sample string 5",
"DisplayName": "sample string 6",
"DevicesCheckIntervalMinutes": 7,
"MeasurementCollectionIntervalMinutes": 8,
"Links": [
{
"Href": "sample string 1",
"Rel": "sample string 2",
"Action": "sample string 3"
},
{
"Href": "sample string 1",
"Rel": "sample string 2",
"Action": "sample string 3"
}
],
"Actions": [
{
"Href": "sample string 1",
"Rel": "sample string 2",
"Action": "sample string 3"
},
{
"Href": "sample string 1",
"Rel": "sample string 2",
"Action": "sample string 3"
}
],
"Description": "sample string 9",
"Enabled": true,
"Authenticated": true
},
{
"Lights": [
{
"LifxId": "sample string 1",
"Assigned": true,
"DeviceId": "19aade9a-beee-44fc-b6e2-9098feba725e",
"Name": "sample string 4",
"Power": "sample string 5",
"Connected": true,
"BrightnessPercentage": 7,
"GroupName": "sample string 8",
"LocationName": "sample string 9",
"Hue": 10.1,
"ColorTemperature": 11,
"Saturation": 12.1,
"ProductName": "sample string 13",
"LastSeen": "2025-10-23T09:44:42.0257768+00:00",
"Links": [],
"Actions": []
},
{
"LifxId": "sample string 1",
"Assigned": true,
"DeviceId": "19aade9a-beee-44fc-b6e2-9098feba725e",
"Name": "sample string 4",
"Power": "sample string 5",
"Connected": true,
"BrightnessPercentage": 7,
"GroupName": "sample string 8",
"LocationName": "sample string 9",
"Hue": 10.1,
"ColorTemperature": 11,
"Saturation": 12.1,
"ProductName": "sample string 13",
"LastSeen": "2025-10-23T09:44:42.0257768+00:00",
"Links": [],
"Actions": []
}
],
"Id": "96412fab-803e-46d8-bbca-24fd94f9e6ab",
"Name": "sample string 2",
"UserName": "sample string 3",
"FullUserName": "sample string 4",
"BotType": "sample string 5",
"DisplayName": "sample string 6",
"DevicesCheckIntervalMinutes": 7,
"MeasurementCollectionIntervalMinutes": 8,
"Links": [
{
"Href": "sample string 1",
"Rel": "sample string 2",
"Action": "sample string 3"
},
{
"Href": "sample string 1",
"Rel": "sample string 2",
"Action": "sample string 3"
}
],
"Actions": [
{
"Href": "sample string 1",
"Rel": "sample string 2",
"Action": "sample string 3"
},
{
"Href": "sample string 1",
"Rel": "sample string 2",
"Action": "sample string 3"
}
],
"Description": "sample string 9",
"Enabled": true,
"Authenticated": true
}
]
application/xml, text/xml
Sample:
<ArrayOfLifxBotDto xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Bots.LifxBot">
<LifxBotDto>
<Actions xmlns:d3p1="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Shared" xmlns="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Bots">
<d3p1:LinkViewModel>
<d3p1:Action>sample string 3</d3p1:Action>
<d3p1:Href>sample string 1</d3p1:Href>
<d3p1:Rel>sample string 2</d3p1:Rel>
</d3p1:LinkViewModel>
<d3p1:LinkViewModel>
<d3p1:Action>sample string 3</d3p1:Action>
<d3p1:Href>sample string 1</d3p1:Href>
<d3p1:Rel>sample string 2</d3p1:Rel>
</d3p1:LinkViewModel>
</Actions>
<Authenticated xmlns="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Bots">true</Authenticated>
<BotType xmlns="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Bots">sample string 5</BotType>
<Description xmlns="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Bots">sample string 9</Description>
<DevicesCheckIntervalMinutes xmlns="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Bots">7</DevicesCheckIntervalMinutes>
<DisplayName xmlns="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Bots">sample string 6</DisplayName>
<Enabled xmlns="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Bots">true</Enabled>
<FullUserName xmlns="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Bots">sample string 4</FullUserName>
<Id xmlns="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Bots">96412fab-803e-46d8-bbca-24fd94f9e6ab</Id>
<Links xmlns:d3p1="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Shared" xmlns="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Bots">
<d3p1:LinkViewModel>
<d3p1:Action>sample string 3</d3p1:Action>
<d3p1:Href>sample string 1</d3p1:Href>
<d3p1:Rel>sample string 2</d3p1:Rel>
</d3p1:LinkViewModel>
<d3p1:LinkViewModel>
<d3p1:Action>sample string 3</d3p1:Action>
<d3p1:Href>sample string 1</d3p1:Href>
<d3p1:Rel>sample string 2</d3p1:Rel>
</d3p1:LinkViewModel>
</Links>
<MeasurementCollectionIntervalMinutes xmlns="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Bots">8</MeasurementCollectionIntervalMinutes>
<Name xmlns="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Bots">sample string 2</Name>
<UserName xmlns="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Bots">sample string 3</UserName>
<Lights>
<LifxLightDto>
<Actions xmlns:d5p1="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Shared" />
<Assigned>true</Assigned>
<BrightnessPercentage>7</BrightnessPercentage>
<ColorTemperature>11</ColorTemperature>
<Connected>true</Connected>
<DeviceId>19aade9a-beee-44fc-b6e2-9098feba725e</DeviceId>
<GroupName>sample string 8</GroupName>
<Hue>10.1</Hue>
<LastSeen>2025-10-23T09:44:42.0257768+00:00</LastSeen>
<LifxId>sample string 1</LifxId>
<Links xmlns:d5p1="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Shared" />
<LocationName>sample string 9</LocationName>
<Name>sample string 4</Name>
<Power>sample string 5</Power>
<ProductName>sample string 13</ProductName>
<Saturation>12.1</Saturation>
</LifxLightDto>
<LifxLightDto>
<Actions xmlns:d5p1="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Shared" />
<Assigned>true</Assigned>
<BrightnessPercentage>7</BrightnessPercentage>
<ColorTemperature>11</ColorTemperature>
<Connected>true</Connected>
<DeviceId>19aade9a-beee-44fc-b6e2-9098feba725e</DeviceId>
<GroupName>sample string 8</GroupName>
<Hue>10.1</Hue>
<LastSeen>2025-10-23T09:44:42.0257768+00:00</LastSeen>
<LifxId>sample string 1</LifxId>
<Links xmlns:d5p1="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Shared" />
<LocationName>sample string 9</LocationName>
<Name>sample string 4</Name>
<Power>sample string 5</Power>
<ProductName>sample string 13</ProductName>
<Saturation>12.1</Saturation>
</LifxLightDto>
</Lights>
</LifxBotDto>
<LifxBotDto>
<Actions xmlns:d3p1="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Shared" xmlns="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Bots">
<d3p1:LinkViewModel>
<d3p1:Action>sample string 3</d3p1:Action>
<d3p1:Href>sample string 1</d3p1:Href>
<d3p1:Rel>sample string 2</d3p1:Rel>
</d3p1:LinkViewModel>
<d3p1:LinkViewModel>
<d3p1:Action>sample string 3</d3p1:Action>
<d3p1:Href>sample string 1</d3p1:Href>
<d3p1:Rel>sample string 2</d3p1:Rel>
</d3p1:LinkViewModel>
</Actions>
<Authenticated xmlns="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Bots">true</Authenticated>
<BotType xmlns="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Bots">sample string 5</BotType>
<Description xmlns="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Bots">sample string 9</Description>
<DevicesCheckIntervalMinutes xmlns="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Bots">7</DevicesCheckIntervalMinutes>
<DisplayName xmlns="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Bots">sample string 6</DisplayName>
<Enabled xmlns="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Bots">true</Enabled>
<FullUserName xmlns="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Bots">sample string 4</FullUserName>
<Id xmlns="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Bots">96412fab-803e-46d8-bbca-24fd94f9e6ab</Id>
<Links xmlns:d3p1="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Shared" xmlns="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Bots">
<d3p1:LinkViewModel>
<d3p1:Action>sample string 3</d3p1:Action>
<d3p1:Href>sample string 1</d3p1:Href>
<d3p1:Rel>sample string 2</d3p1:Rel>
</d3p1:LinkViewModel>
<d3p1:LinkViewModel>
<d3p1:Action>sample string 3</d3p1:Action>
<d3p1:Href>sample string 1</d3p1:Href>
<d3p1:Rel>sample string 2</d3p1:Rel>
</d3p1:LinkViewModel>
</Links>
<MeasurementCollectionIntervalMinutes xmlns="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Bots">8</MeasurementCollectionIntervalMinutes>
<Name xmlns="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Bots">sample string 2</Name>
<UserName xmlns="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Bots">sample string 3</UserName>
<Lights>
<LifxLightDto>
<Actions xmlns:d5p1="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Shared" />
<Assigned>true</Assigned>
<BrightnessPercentage>7</BrightnessPercentage>
<ColorTemperature>11</ColorTemperature>
<Connected>true</Connected>
<DeviceId>19aade9a-beee-44fc-b6e2-9098feba725e</DeviceId>
<GroupName>sample string 8</GroupName>
<Hue>10.1</Hue>
<LastSeen>2025-10-23T09:44:42.0257768+00:00</LastSeen>
<LifxId>sample string 1</LifxId>
<Links xmlns:d5p1="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Shared" />
<LocationName>sample string 9</LocationName>
<Name>sample string 4</Name>
<Power>sample string 5</Power>
<ProductName>sample string 13</ProductName>
<Saturation>12.1</Saturation>
</LifxLightDto>
<LifxLightDto>
<Actions xmlns:d5p1="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Shared" />
<Assigned>true</Assigned>
<BrightnessPercentage>7</BrightnessPercentage>
<ColorTemperature>11</ColorTemperature>
<Connected>true</Connected>
<DeviceId>19aade9a-beee-44fc-b6e2-9098feba725e</DeviceId>
<GroupName>sample string 8</GroupName>
<Hue>10.1</Hue>
<LastSeen>2025-10-23T09:44:42.0257768+00:00</LastSeen>
<LifxId>sample string 1</LifxId>
<Links xmlns:d5p1="http://schemas.datacontract.org/2004/07/AnalysisUK.Tinamous.www.ApiControllers.Models.Shared" />
<LocationName>sample string 9</LocationName>
<Name>sample string 4</Name>
<Power>sample string 5</Power>
<ProductName>sample string 13</ProductName>
<Saturation>12.1</Saturation>
</LifxLightDto>
</Lights>
</LifxBotDto>
</ArrayOfLifxBotDto>