---
title: "List All Apps"
method: GET
path: "/smartapps"
tags: ["SmartApps"]
---

# List All Apps

`GET /smartapps`

## Request

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

List all apps configured in an account.

## Query parameters

- `appType` 'LAMBDA_SMART_APP' | 'WEBHOOK_SMART_APP'
- `classification` 'AUTOMATION' | 'SERVICE' | 'DEVICE' | 'CONNECTED_SERVICE'
- `tag` string, ^[a-zA-Z_]{1,64}$
- `accountId` string, uuid

## Headers

- `Authorization` string, string, required

## Response `200`

A paginated list of apps.

- PagedApps: Represents a single page of Apps available in an account.
  - `items` PagedApp[]
    - `appName` string, ^[a-z0-9.-_]{1,250}$: A user defined unique identifier for an app. It is alpha-numeric, may contain dashes, underscores, periods, and be less then 250 characters long. It must be unique within your account.
    - `appId` string, uuid: A globally unique identifier for an app.
    - `appType` 'LAMBDA_SMART_APP' | 'WEBHOOK_SMART_APP' | 'API_ONLY': Denotes the type of app.
    - `classifications` AppClassification[]: An App maybe associated to many classifications. A classification drives how the integration is presented to the user in the SmartThings mobile clients. These classifications include: * AUTOMATION - Denotes an integration that should display under the "Automation" tab in mobile clients. * SERVICE - Denotes an integration that is classified as a "Service". * DEVICE - Denotes an integration that should display under the "Device" tab in mobile clients. * CONNECTED_SERVICE - Denotes an integration that should display under the "Connected Services" menu in mobile clients. * HIDDEN - Denotes an integration that should not display in mobile clients * LABS - Denotes an ingration that should display under the "Labs" menu in the modile clients.
    - `displayName` string: A default display name for an app.
    - `description` string: A default description for an app.
    - `iconImage` IconImage: A default icon image for the app.
      - `url` string, uri: A default icon image url for an app. https url required.
    - `owner` Owner: A typed model which provides information around ownership of a specific domain.
      - `ownerType` 'USER' | 'SYSTEM' | 'IMPLICIT' | 'ACCOUNT', required: The type of owner that owns this entity. "Account" refers specifically to a coterie account ID.
      - `ownerId` string, required: A global identifier for owner.
    - `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

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

## Changes

- **2026-11-07** `2788a4236800`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/smartthings/apis/smartthings-api/changes/smartapps/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)