---
title: "Get Devices By InstalledSchemaApp ID"
method: GET
path: "/schema/installedapps/{isaId}"
tags: ["InstalledSchemaApps"]
---

# Get Devices By InstalledSchemaApp ID

`GET /schema/installedapps/{isaId}`

## Request

- Base URL: `https://api.smartthings.com/v1`
- URL: `https://api.smartthings.com/v1/schema/installedapps/{isaId}`
- Auth: none declared. Required headers: `Authorization`
- TypeScript: <https://skmtc.dev/smartthings/apis/smartthings-api/docs/schema/installedapps/:isaId/get.ts> (a function with typed inputs; its response is checked against the schema)

Get devices and app related info for a given `isaId`.
If relogin is not required, the pageType will be set to "loggedIn" and SmartThings will return the `isaId`, devices, `partnerName`, `appName` and icons.
If relogin is needed, the pageType will be set to "requiresLogin" and the "oauthLink" value will be populated in the response.
For both pageTypes, if the integration is LAN-hybrid, driverId is also returned.

## Query parameters

- `redirectRequested` boolean
- `jsonRspRequested` boolean

## Response `200`

Success

- Isa
  - `pageType` string: Possible values - __requiresLogin__ or __loggedIn__. These two values determine what fields are returned in this response. If value is "requiresLogin", "oAuthLink" is returned in the response. If value is "loggedIn", isaId, partnerName, appName, devices and icons are returned. For both values, if the integration is LAN-hybrid, driverId is also returned.
  - `isaId` string: isaId (Installed App Id)
  - `endpointAppId` string: endpoint app id of the installed smart app
  - `partnerName` string: partner or brand name eg LIFX Inc.
  - `appName` string: Connector name. eg Lifx (Connect)
  - `icon` string: url of partner icon
  - `icon2x` string: url of partner icon in 2x dimensions
  - `icon3x` string: url of partner icon in 3x dimensions
  - `locationId` string: location of the installed smart app
  - `devices` DeviceResults[]
    - `deviceId` string: deviceId created by DM
    - `name` string: initial device name from the partner
  - `oAuthLink` string: generated oAuth link for the user to login to partner server. This will only be returned when the user is not logged in.
  - `viperAppLinks` ViperAppLinks
    - `android` string: app deep linking to partners in android
    - `ios` string: app deep linking to partners in ios
    - `isLinkingEnabled` boolean: whether deep app linking is enabled
  - `partnerSTConnection` 'connected' | 'disconnected': connection status between partner and ST platform
  - `stEulaFileName` string: file name for the EULA PII page
  - `stEulaLocksmithKey` string: locksmith key for EULA
  - `driverId` string: Unique identifier of the driver. This field will only be returned for LAN-hybrid integrations.

## Other responses

- `400`: BadRequest
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `500`: InternalServiceError

## Changes

- **2025-02-11** `32f2af0e7ed1`: 1 info
  - added the new optional `query` request parameter `jsonRspRequested`
- **2023-11-27** `e8dd260a33ec`: 1 info
  - added the new optional `query` request parameter `redirectRequested`
- **2022-12-19** `adcacfc2749d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/smartthings/apis/smartthings-api/changes/schema/installedapps/:isaId/get.md)

---

[API](https://skmtc.dev/smartthings/apis/smartthings-api.md) - [All operations](https://skmtc.dev/smartthings/apis/smartthings-api/llms.txt) - [OpenAPI document](https://skmtc.dev/smartthings/apis/smartthings-api/revisions/2788a4236800?raw)