---
title: "Get a registry plugin"
method: GET
path: "/registry/{registryName}/v0.1/x/dev.toolhive/plugins/{namespace}/{pluginName}"
tags: ["registry-plugins"]
---

# Get a registry plugin

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

Retrieve a single plugin by its namespace and name from the registry.

## Path parameters

- `registryName` string, required
- `namespace` string, required
- `pluginName` string, required

## Response `200`

OK

- RegistryPlugin
  - `_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

- `404` — Plugin not found
- `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/:namespace/:pluginName/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)