---
title: "List available registry plugins"
method: GET
path: "/registry/{registryName}/v0.1/x/dev.toolhive/plugins"
tags: ["registry-plugins"]
---

# List available registry plugins

`GET /registry/{registryName}/v0.1/x/dev.toolhive/plugins`

Get a paginated list of plugins from the registry. Supports optional full-text search and pagination.

## Path parameters

- `registryName` string, required

## Query parameters

- `q` string
- `page` integer
- `limit` integer

## Response `200`

OK

- PkgApiV1PluginsV01Response — Paginated list of plugins from the registry
  - `metadata` PkgApiV1PaginationV01Metadata — Metadata contains pagination information
    - `limit` integer — Limit is the maximum number of items per page
    - `page` integer — Page is the current page number (1-based)
    - `total` integer — Total is the total number of items matching the query
  - `plugins` RegistryPlugin[] — Plugins is the list of plugins on the current page
    - `_meta` object — Meta is an opaque payload with extended meta data details of the plugin.
    - `description` string — Description is the description of the plugin.
    - `icons` RegistrySkillIcon[] — Icons is the list of icons for the plugin.
      - `label` string — Label is the label of the icon.
      - `size` string — Size is the size of the icon.
      - `src` string — Src is the source of the icon.
      - `type` string — Type is the type of the icon.
    - `license` string — License is the SPDX license identifier of the plugin.
    - `metadata` object — Metadata is the official metadata of the plugin as reported in the plugin manifest file.
    - `name` string — Name is the name of the plugin. The format is that of identifiers, e.g. "my-plugin".
    - `namespace` string — Namespace is the namespace of the plugin. The format is reverse-DNS, e.g. "io.github.user".
    - `packages` RegistrySkillPackage[] — Packages is the list of packages for the plugin.
      - `commit` string — Commit is the commit of the package.
      - `digest` string — Digest is the digest of the package.
      - `identifier` string — Identifier is the OCI identifier of the package.
      - `mediaType` string — MediaType is the media type of the package.
      - `ref` string — Ref is the reference of the package.
      - `registryType` string — RegistryType is the type of registry the package is from. Can be "oci" or "git".
      - `subfolder` string — Subfolder is the subfolder of the package.
      - `url` string — URL is the URL of the package.
    - `repository` RegistrySkillRepository — Repository is the source repository of the skill.
      - `type` string — Type is the type of the repository.
      - `url` string — URL is the URL of the repository.
    - `status` string — Status is the status of the plugin. Can be one of "active", "deprecated", or "archived".
    - `title` string — Title is the title of the plugin. This is for human consumption, not an identifier.
    - `version` string — Version is the version of the plugin. Any non-empty string is valid, but ideally it should be either a semantic version or a commit hash.

## Other responses

- `500` — Internal server error
- `503` — Registry authentication required or upstream registry unavailable

## Changes

- **2026-08-05** `43b22ce40564` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/stacklok/apis/toolhive-api/changes/registry/:registryName/v0.1/x/dev.toolhive/plugins/get.md)

---

[API](https://skmtc.dev/stacklok/apis/toolhive-api.md) · [All operations](https://skmtc.dev/stacklok/apis/toolhive-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/stacklok/toolhive-api/revisions/e9f942effcda/schema)