---
title: "Retrieves the list of hub installed driver"
method: GET
path: "/hubdevices/{hubDeviceId}/drivers"
tags: ["HubDevices"]
---

# Retrieves the list of hub installed driver

`GET /hubdevices/{hubDeviceId}/drivers`

## Request

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

Returns the list of drivers currently installed on the hub

## Path parameters

- `hubDeviceId` 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

- `deviceId` string

## Headers

- `Authorization` string, string, required
- `Accept-Language` string

## Response `200`

List of hub installed drivers

- InstalledDriver[]: List of installed Hub Device drivers
  - `driverId` string, required: Unique Identifier of the driver
  - `name` string, required: User friendly Identifier for Driver
  - `description` string: Description of Driver
  - `version` string, required: version of the driver currently in use
  - `channelId` string: identifier for channel this driver is installed from
  - `developer` string: developer of the driver
  - `vendorSupportInformation` string: information on how to reach vendor
  - `permissions` object: map of permissions and attributes used by the driver. In format of {"permissions":{"perm1":{...}, "perm2"{...}}}
  - `isWWST` boolean: Flag to denote that this driver is part of a works with SmartThings channel

## Other responses

- `400`: Bad request
- `403`: Forbidden

## Changes

- **2022-12-19** `adcacfc2749d`: 1 info
  - endpoint added

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