# Get Extension

`GET /extensions-admin/{slug}` · Core · Extensions

Returns the per-project enable record for the specified extension on this project — including the enable status, current manifest version, permission grants, schema name, and the `hookSecret` (HMAC shared secret for hook signature verification). This endpoint allows the extension to recover the `hookSecret` after a process restart without requiring a disable and re-enable cycle. Requires `PROJECT_ADMIN`.

## Parameters

| Name | In | Required | Description |
|---|---|---|---|
| `slug` | path | yes |  Example: `"demoext"`. |
| `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` | object | yes |  |
| `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.config` | object | yes | The install's configuration, as name to value. |
| `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_ | | |  |
| `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 retrieving extension detail on this project; a PROJECT_ADMIN role is required for the hookSecret field. |
| 404 | `K9O_EXTENSION_NOT_FOUND` | No extension with this slug exists in the registry. |

## Code samples

### cURL

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

### fetch

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


Canonical page: https://docs.kilimanjaro.dev/api-playground/core/get-extension
