---
title: "Get a registry"
method: GET
path: "/api/v1beta/registry/{name}"
tags: ["registry"]
---

# Get a registry

`GET /api/v1beta/registry/{name}`

Get details of a specific registry

## Path parameters

- `name` string, required

## Response `200`

OK

- PkgApiV1GetRegistryResponse — Response containing registry details
  - `auth_config` GithubComStacklokToolhivePkgRegistryOAuthPublicConfig — AuthConfig contains the non-secret OAuth configuration when auth is configured. Nil when auth_status is "none".
    - `audience` string
    - `client_id` string
    - `issuer` string
    - `scopes` string[]
  - `auth_status` string — AuthStatus is one of: "none", "configured", "authenticated". Intentionally omits omitempty — see registryInfo for rationale.
  - `auth_type` string — AuthType is "oauth", "bearer" (future), or empty string when no auth. Intentionally omits omitempty — see registryInfo for rationale.
  - `last_updated` string — Last updated timestamp
  - `name` string — Name of the registry
  - `registry` RegistryRegistry — Full registry data
    - `groups` RegistryGroup[] — Groups is a slice of group definitions containing related MCP servers
      - `description` string — Description is a human-readable description of the group's purpose and functionality
      - `name` string — Name is the identifier for the group, used when referencing the group in commands
      - `remote_servers` object — RemoteServers is a map of server names to their corresponding remote server definitions within this group
      - `servers` object — Servers is a map of server names to their corresponding server definitions within this group
    - `last_updated` string — LastUpdated is the timestamp when the registry was last updated, in RFC3339 format
    - `remote_servers` object — RemoteServers is a map of server names to their corresponding remote server definitions These are MCP servers accessed via HTTP/HTTPS using the thv proxy command
    - `servers` object — Servers is a map of server names to their corresponding server definitions
    - `version` string — Version is the schema version of the registry
  - `server_count` integer — Number of servers in the registry
  - `source` string — Source of the registry (URL, file path, or empty string for built-in)
  - `type` 'file' | 'url' | 'api' | 'default' — Type of registry (file, url, or default)
  - `version` string — Version of the registry schema

## Other responses

- `404` — Not Found

## Changes

- **2026-06-25** `eca05ec353c1` — 4 info
  - added the optional property `registry/groups/items/remote_servers/additionalProperties/stateless` to the response with the `200` status
  - added the optional property `registry/groups/items/servers/additionalProperties/stateless` to the response with the `200` status
  - added the optional property `registry/remote_servers/additionalProperties/stateless` to the response with the `200` status
  - added the optional property `registry/servers/additionalProperties/stateless` to the response with the `200` status
- **2026-03-24** `4d5fd24904e8` — 3 info
  - added the optional property `auth_config` to the response with the `200` status
  - added the optional property `auth_status` to the response with the `200` status
  - added the optional property `auth_type` to the response with the `200` status
- **2026-03-17** `8ab2f5690c97` — 1 info
  - added the optional property `registry` to the response with the `200` status
- **2026-03-03** `3e1a5843166a` — 1 warning
  - removed the optional property `registry` from the response with the `200` status
- …earlier changes not shown

[Full history](https://skmtc.dev/stacklok/apis/toolhive-api/changes/api/v1beta/registry/:name/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)