---
title: "List a Capability's Versions"
method: GET
path: "/capabilities/{capabilityId}"
tags: ["Capabilities"]
---

# List a Capability's Versions

`GET /capabilities/{capabilityId}`

## Request

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

List a Capability's versions.

## Response `200`

successful return of a Capability

- PagedCapabilities
  - `items` CapabilitySummary[]
    - `id` string, required: A URL safe unique identifier for the capability.
    - `version` integer, required: The version number of the capability.
    - `status` 'proposed' | 'live' | 'deprecated' | 'dead', required: The status of the capability. * __proposed__ - The capability is under a review and refinement process. The capability definition may go through changes, some of which may be breaking. * __live__ - The capability has been through review and the definition has been solidified. Live capabilities can no longer be altered. * __deprecated__ - The capability is marked for removal and should only be used during a period of migration to allow for existing integrations and automations to continue to work. * __dead__ - The usage of a deprecated capability has dropped to a sufficiently low level to warrant removal. The capability definition still exists but can no longer be used by automations or implemented by devices.
    - `ephemeral` boolean
  - `_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
- `404`: Not found
- `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)