---
title: "Get an Installed App Configuration"
method: GET
path: "/installedapps/{installedAppId}/configs/{configurationId}"
tags: ["Installedapps"]
---

# Get an Installed App Configuration

`GET /installedapps/{installedAppId}/configs/{configurationId}`

## Request

- Base URL: `https://api.smartthings.com/v1`
- URL: `https://api.smartthings.com/v1/installedapps/{installedAppId}/configs/{configurationId}`
- 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/:configurationId/get.ts> (a function with typed inputs; its response is checked against the schema)

Fetch a detailed install configuration model containing actual config entries / values.

## 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
- `configurationId` string, uuid, required

## Headers

- `Authorization` string, string, required

## Response `200`

An install configuration detail model.

- InstallConfigurationDetail: Encompasses both a configuration value, and any required permissions that maybe needed.
  - `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.
  - `config` ConfigMap: A multi-map of configurations for an Installed App. The map 'key' is the configuration name and the 'value' is an array of ConfigEntry models each containing a value and associated permissions. The config key is alpha-numeric, may contain dashes, underscores, periods, and must be less then 50 characters long.
  - `createdDate` string, date-time: A UTC ISO-8601 Date-Time String
  - `lastUpdatedDate` string, date-time: A UTC ISO-8601 Date-Time String

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