---
title: "List Capabilities by Namespace"
method: GET
path: "/capabilities/namespaces/{namespace}"
tags: ["Capabilities"]
---

# List Capabilities by Namespace

`GET /capabilities/namespaces/{namespace}`

## Request

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

List Capabilities by namespace.

Namespaces are used to organize a user's Capabilities and provide a way to uniquely identify them. A user can
retrieve all of the Capabilities under their assigned namespace by referencing it.

The namespace is recognizable as the first part of a capabilityId in the format `namespace.capabilityName`.

## Headers

- `X-ST-Organization` 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}))$

## Response `200`

Successful return of a namespace's Capabilities

- 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
- `429`: Too many requests
- `default`: Unexpected error

## Changes

- **2022-12-19** `adcacfc2749d`: 1 info
  - added the new optional `header` request parameter `X-ST-Organization`

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