Devices

Gets a Device by it's ID

Gets a Device by it's ID

get/Devices/{id}

Request

  • Base URL: https://api.smart-me.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.smart-me.com/Devices/{id}
  • Auth: one of:
    • OAuth 2 (authorization code, authorization URL /oauth/authorize, token URL /oauth/token; client credentials, token URL /oauth/token)
    • HTTP basic

Path parameters

idstring uuid required

The ID of the device

Response

OK

idstring uuid

The ID of the device

namestring nullable

The Name of the Device

serialinteger

The Serial number

isEnabledboolean

Flag if the device is enabled. Disabled devices don't receive new values.

deviceEnergyType0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13
<p>Members: </p><ul><li><i>0</i> - MeterTypeUnknown</li><li><i>1</i> - MeterTypeElectricity</li><li><i>2</i> - MeterTypeWater</li><li><i>3</i> - MeterTypeGas</li><li><i>4</i> - MeterTypeHeat</li><li><i>5</i> - MeterTypeHCA</li><li><i>6</i> - MeterTypeAllMeters</li><li><i>7</i> - MeterTypeTemperature</li><li><i>8</i> - MeterTypeMBusGateway</li><li><i>9</i> - MeterTypeRS485Gateway</li><li><i>10</i> - MeterTypeCustomDevice</li><li><i>11</i> - MeterTypeCompressedAir</li><li><i>12</i> - MeterTypeSolarLog</li><li><i>13</i> - MeterTypeVirtualMeter</li></ul>
meterSubType0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9
<p>Members: </p><ul><li><i>0</i> - MeterSubTypeUnknown</li><li><i>1</i> - Cold / Cold Water Meter</li><li><i>2</i> - Heat / Hot Water Meter</li><li><i>3</i> - MeterSubTypeChargingStation</li><li><i>4</i> - MeterSubTypeElectricity</li><li><i>5</i> - MeterSubTypeWater</li><li><i>6</i> - MeterSubTypeGas</li><li><i>7</i> - Electricity / Heat meter</li><li><i>8</i> - A Temperature meter</li><li><i>9</i> - MeterSubTypeVirtualBattery</li></ul>
familyType0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 14 | 16 | 17 | 18 | 19 | 21 | 65 | 70 | 1001 | 1002 | 1003

The Family Type of the meter (e.g. Smart-me connect meter)<p>Members: </p><ul><li><i>0</i> - The Family Type is unknown (S0 meters, ...)</li><li><i>1</i> - smart-me connect Meter (Plugin Power Meter)</li><li><i>2</i> - smart-me Meter (1-Phase DIN Rail Meter) without switch</li><li><i>3</i> - smart-me Meter (1-Phase DIN Rail Meter) with a Switch</li><li><i>4</i> - smart-me M-BUS Gateway V1</li><li><i>5</i> - Reserved for the retired smart-me RS-485 Gateway V1</li><li><i>6</i> - MeterFamilyTypeKamstrupModule</li><li><i>7</i> - MeterFamilyTypeSmartMe3PhaseMeter80A</li><li><i>8</i> - smart-me 3-Phase Meter 32A (with Switch)</li><li><i>9</i> - smart-me 3-Phase Meter Transformer Edition</li><li><i>10</i> - smart-me Landis Gyr Module</li><li><i>11</i> - Optical module for the FNN meters</li><li><i>12</i> - smart-me 3-Phase Meter 80A with the new WiFi (V2)</li><li><i>14</i> - smart-me 3-Phase Meter 80A with Mobile</li><li><i>16</i> - smart-me 1-Phase Meter 80A with the new WiFi (V2)</li><li><i>17</i> - smart-me 1-Phase Meter 32A with the new WiFi (V2)</li><li><i>18</i> - smart-me 1-Phase Meter 80A with GPRS</li><li><i>19</i> - smart-me 1-Phase Meter 32A with GPRS</li><li><i>21</i> - smart-me 3-Phase Meter Transformer Edition with mobile module</li><li><i>65</i> - smart-me 3-phase Meter Nimbus (3-point meter)</li><li><i>70</i> - Mithral hall charging station Version 1</li><li><i>1001</i> - REST API Meter</li><li><i>1002</i> - Virtual billing Meter (e.g. for smart-me washroom)</li><li><i>1003</i> - M-BUS Meter read out by a smart-me M-BUS Gateway</li></ul>

activePowernumber double nullable

The Actvie Power or current flow rate

activePowerL1number double nullable

The Actvie Power Phase L1

activePowerL2number double nullable

The Actvie Power Phase L2

activePowerL3number double nullable

The Actvie Power Phase L3

activePowerUnitstring nullable

The Unit of the Active Power Value

counterReadingnumber double nullable

The Meter Counter Reading (Total Energy used)

counterReadingUnitstring nullable

The Unit of the Counter Reading

counterReadingT1number double nullable

The Meter Counter Reading Tariff 1

counterReadingT2number double nullable

The Meter Counter Reading Tariff 2

counterReadingT3number double nullable

The Meter Counter Reading Tariff 3

counterReadingT4number double nullable

The Meter Counter Reading Tariff 4

counterReadingImportnumber double nullable

The Meter Counter Reading only import

counterReadingExportnumber double nullable

The Meter Counter Reading only export

switchOnboolean nullable

Flag if the Switch is on on this device.

switchPhaseL1Onboolean nullable

Flag if the Phase L1 is on on this device.

switchPhaseL2Onboolean nullable

Flag if the Phase L2 is on on this device.

switchPhaseL3Onboolean nullable

Flag if the Phase L3 is on on this device.

voltagenumber double nullable

The Voltage (in V)

voltageL1number double nullable

The Voltage Phase L1 (in V)

voltageL2number double nullable

The Voltage Phase L2 (in V)

voltageL3number double nullable

The Voltage Phase L3 (in V)

currentnumber double nullable

The Current (in A)

currentL1number double nullable

The Current Phase L1 (in A)

currentL2number double nullable

The Current Phase L2 (in A)

currentL3number double nullable

The Current Phase L3 (in A)

powerFactornumber double nullable

The Power Factor (cos phi). Range: 0 - 1

powerFactorL1number double nullable

The Power Factor (cos phi) Phase L1. Range: 0 - 1

powerFactorL2number double nullable

The Power Factor (cos phi) Phase L2. Range: 0 - 1

powerFactorL3number double nullable

The Power Factor (cos phi) Phase L3. Range: 0 - 1

temperaturenumber double nullable

The Temperature (in degree celsius)

activeTariffinteger nullable

The Number of the Active Tariff

digitalOutput1boolean nullable

The digital output number 1

digitalOutput2boolean nullable

The digital output number 2

analogOutput1integer nullable

The analog output number 1 (PWM signal) (0 - 32183)

analogOutput2integer nullable

The analog output number 2 (PWM signal) (0 - 32183)

digitalInput1boolean nullable

The digital input number 1

digitalInput2boolean nullable

The digital input number 2

valueDatestring date-time nullable

Time of last successful connection the the smart-me Cloud.

additionalMeterSerialNumberstring nullable

An additional Meter serial number. e.g. the number of a meter a smart-me device is connected to.

flowRatenumber double nullable

The current flow rate (e.g. m3/h)

chargingStationState0 | 1 | 2 | 3 | 4 | 5 | 6 | 7

State of a (pico) charging station<p>Members: </p><ul><li><i>0</i> - Booting</li><li><i>1</i> - ReadyNoCarConnected</li><li><i>2</i> - ReadyCarConnected</li><li><i>3</i> - StartedWaitForCar</li><li><i>4</i> - Charging</li><li><i>5</i> - Installation</li><li><i>6</i> - Authorize</li><li><i>7</i> - Offline</li></ul>

Changes

No recorded changes to this operation across all 1 revision of this API.