SMsmartthings
Profiles

Get a Device Profile

Changed on

Retrieve the Device Profile of a given Device.

get/deviceprofiles/{deviceProfileId}

Request

Headers

Accept-Languagestring

Language header representing the client's preferred language. The format of the Accept-Language header follows what is defined in RFC 7231, section 5.3.5

Response

A Device Profile

idstring required
namestring required
metadataunknown
presentationIdstring
migrationStatus'MIGRATED' | 'NOT_MIGRATED' required
status'DEVELOPMENT' | 'PUBLISHED' required

The lifecycle status of a device profile. 'DEVELOPMENT' - Device profile can be modified. The profile is only available to the developer and can only be used with a self-published app. 'PUBLISHED' - Device profile can be shared with other users, but cannot be modified.

Example response

{
  "id": "a362ddb6-349b-4650-9911-681b51069a57",
  "name": "thermostat1.model1",
  "metadata": {
    "firmWareVersion": "0.2.123",
    "manufacturerName": "SmartThingsCommunity"
  },
  "presentationId": "perfectlife6617.custom-thermostat",
  "preferences": [
    {
      "title": "Temperature Offset",
      "description": "The offset for a particular temperature setting"
    }
  ],
  "components": [
    {
      "id": "main",
      "capabilities": [
        {
          "id": "switch",
          "version": 1,
          "config": {
            "values": [
              {
                "key": "thermostatMode.value"
              }
            ]
          },
          "status": {
            "switch": {
              "value": "on"
            }
          }
        }
      ],
      "categories": [
        {
          "name": "Light"
        }
      ]
    }
  ]
}

Changes