# List Extensions

`GET /extensions-admin` · Core · Extensions

Returns the list of extensions currently enabled (or previously installed) on the specified project, including each extension's status, manifest version, enabled-at timestamp, and permission grants. This is the project-scoped view; it shows only extensions relevant to this project, not the full org registry. Requires at minimum `PROJECT_VIEWER` authentication.

## Parameters

| Name | In | Required | Description |
|---|---|---|---|
| `projectSlug` | path | yes | The project's slug: the path segment after `@`. It is unique within the org. Example: `"storefront"`. |

## Responses

- **200**: Success

| Field | Type | Required | Description |
|---|---|---|---|
| `data` | array of object | yes | The extensions installed on the project, oldest first. Purged installs are left out. |
| `data.[]installId` | string | yes | The project's install record for the extension (`xinst_...`). |
| `data.[]extensionId` | string | yes | The extension's id in the org's registry (`ext_...`). |
| `data.[]extensionSlug` | string | yes | The extension's slug. |
| `data.[]manifestVersion` | string | yes | The version installed on this project. |
| `data.[]status` | enum ("queued", "installing", "enabled", "disabled", "purged", "failed", "stalled") | yes | The install's state: `enabled` and `disabled` are the settled states; `queued` and `installing` while it is being set up; `failed` or `stalled` when setup did not finish; `purged` once its data is destroyed. |
| `data.[]enabledAt` | string (date-time) | yes | When the install was first enabled (ISO 8601 UTC). |
| `data.[]disabledAt` | object | yes |  |
| _one of_ | | |  |
| _or_ | | |  |
| `data.[]cli` | array of object | yes | The command-line verbs the extension declares. Empty when it declares none. |
| `data.[]cli.[]verb` | string | yes | The command word. |
| `data.[]cli.[]summary` | string | yes | A one-line description. |
| `data.[]cli.[]invokes` | string | yes | The extension route the command calls, as `METHOD:path`. |
| `data.[]cli.[]args` | array of object | no | The command's arguments. |
| `data.[]cli.[]args.[]name` | string | yes | The argument's name. |
| `data.[]cli.[]args.[]summary` | string | yes | A one-line description. |
| `data.[]cli.[]args.[]position` | enum ("positional", "flag") | yes | `positional` or `flag`. |
| `data.[]cli.[]args.[]type` | enum ("string", "number", "boolean", "json") | yes | The value's type. |
| `data.[]cli.[]args.[]required` | boolean | no | Whether the argument must be given. |
| `data.[]cli.[]args.[]bind` | enum ("path", "query", "body") | no | Where the value goes in the extension route's request. |
| `data.[]updateAvailable` | boolean | yes | True when the org's registry holds a newer version than the one installed, and the install is enabled. |
| `data.[]latestVersion` | object | yes |  |
| _one of_ | | |  |
| _or_ | | |  |
| `data.[]updateBumpType` | object | yes |  |
| _one of_ | | |  |
| _or_ | | |  |
| `data.[]deployment` | object | yes |  |
| _one of_ | | |  |
| _or_ | | |  |
| `meta` | object | yes |  |


## Errors

| HTTP | Code | When |
|---|---|---|
| 401 | `K9O_SESSION_EXPIRED` | Your session has expired; authenticate again to continue. |
| 403 | `K9O_ACCESS_DENIED` | Your role does not permit listing extensions on this project; at least PROJECT_VIEWER is required. |

## Code samples

### cURL

```bash
curl -X GET 'https://<org>.api-<region>.k9o.io/@storefront/extensions-admin' \
  -H 'Authorization: Bearer $K9O_TOKEN'
```

### fetch

```javascript
const res = await fetch('https://<org>.api-<region>.k9o.io/@storefront/extensions-admin', {
  method: 'GET',
  headers: {
    'Authorization': `Bearer ${process.env.K9O_TOKEN}`
  },
});
const { data, meta } = await res.json();
```


Canonical page: https://docs.kilimanjaro.dev/api-playground/core/list-extensions
