---
title: "List an Installed App's Configurations"
method: GET
path: "/installedapps/{installedAppId}/configs"
tags: ["Installedapps"]
---

# List an Installed App's Configurations

`GET /installedapps/{installedAppId}/configs`

## Request

- Base URL: `https://api.smartthings.com/v1`
- URL: `https://api.smartthings.com/v1/installedapps/{installedAppId}/configs`
- Auth: OAuth 2
  - Implicit: `https://auth-global.api.smartthings.com`
  - Scopes: `r:installedapps:*`
- TypeScript: <https://skmtc.dev/smartthings/apis/smartthings-api/docs/installedapps/:installedAppId/configs/get.ts> (a function with typed inputs; its response is checked against the schema)

List all configurations potentially filtered by status for an installed app.

## Path parameters

- `installedAppId` string, ^(?:([0-9a-fA-F]{32})|([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}))$, required

## Query parameters

- `configurationStatus` 'STAGED' | 'DONE' | 'AUTHORIZED' | 'REVOKED'

## Headers

- `Authorization` string, string, required

## Response `200`

A paginated list of install configuration.

- PagedInstallConfigurations: Represents a single page of InstallConfiguration models available for an InstalledApp.
  - `items` InstallConfiguration[]
    - `installedAppId` string, uuid: The ID of the installed app.
    - `configurationId` string, uuid: The ID to this configration instance.
    - `configurationStatus` 'STAGED' | 'DONE' | 'AUTHORIZED' | 'REVOKED': Denotes the current state of a configuration instance. 'STAGED' configuration is used during active modification to config. A configuration is marked 'DONE' once it is deemed finished. At this point it is immutable, meaning it can't be changed. A status of 'AUTHORIZED' means the apps permissions have been authorized by the consumer. Installed Apps in 'AUTHORIZED' state are fully installed and used by the SmartThings platform. A status of 'REVOKED' means the apps permissions have been revoked.
    - `createdDate` string, date-time: A UTC ISO-8601 Date-Time String
    - `lastUpdatedDate` string, date-time: A UTC ISO-8601 Date-Time String
  - `_links` Links
    - `next` Link
      - `href` string: An absolute URL linking to a resource.
    - `previous` Link
      - `href` string: An absolute URL linking to a resource.

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too many requests
- `default`: Unexpected error

---

[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)