# List installed packages

Source: https://docs.vlayers.ai/reference/hosting/list-installs

`GET /v1/installs` · scope `workspace:read`

Lists the third-party packages installed in your workspace, each with the summary of what it can do that you agreed to, whether it is running or stopped (and the words of whoever stopped it), and any newer version waiting for your word.

Requires an API key with the `workspace:read` scope.

## Request

cURL:

```bash
curl https://api.vlayers.ai/v1/installs \
  -H "Authorization: Bearer $VOICELAYER_API_KEY"
```

TypeScript:

```ts
import { VoiceLayer } from '@voicelayer/api';

const voicelayer = new VoiceLayer();

const { installs } = await voicelayer.hosting.listInstalls();
console.log(installs);
```

Python:

```python
from voicelayer import VoiceLayer

vl = VoiceLayer()

result = vl.hosting.list_installs()
print(result.installs)
```

## Response `200`

```json
{
  "installs": [
    {
      "id": "0192f5c3-7a8b-7c9d-8e1f-3a4b5c6d7e89",
      "packageId": "com.example/orders-panel",
      "kind": "tool-set",
      "publisherWorkspaceId": "org_publisher",
      "versionId": "0192f5c1-5e6f-7a8b-9c0d-1e2f3a4b5c67",
      "label": "com.example/orders-panel@1.0.0",
      "state": "active",
      "updateMode": "manual",
      "summary": {
        "lines": [
          {
            "section": "hosts",
            "key": "host:api.example.com",
            "text": "It can send data to api.example.com."
          }
        ],
        "hash": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"
      },
      "consentedBy": "user_2abc",
      "consentedAt": "2026-10-20T15:04:05.000Z",
      "notice": null,
      "pendingUpdate": null,
      "sizeClass": "small",
      "warmCount": 1,
      "screens": false
    }
  ]
}
```
