---
title: "List registries"
method: GET
path: "/api/v1beta/registry"
tags: ["registry"]
---

# List registries

`GET /api/v1beta/registry`

Get a list of the current registries

## Response `200`

OK

- PkgApiV1RegistryListResponse — Response containing a list of registries
  - `registries` PkgApiV1RegistryInfo[] — List of registries
    - `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 so clients always receive the field, even when the value is "none" (the zero-value equivalent).
    - `auth_type` string — AuthType is "oauth", "bearer" (future), or empty string when no auth. Intentionally omits omitempty so clients can distinguish "no auth configured" (empty string) from "field missing" without extra logic.
    - `last_updated` string — Last updated timestamp
    - `name` string — Name 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

## Changes

- **2026-03-24** `4d5fd24904e8` — 3 info
  - added the optional property `registries/items/auth_config` to the response with the `200` status
  - added the optional property `registries/items/auth_status` to the response with the `200` status
  - added the optional property `registries/items/auth_type` to the response with the `200` status
- **2026-01-29** `ff6ce8dd8f3a` — 3 warning
  - removed the optional property `registries/items/auth_config` from the response with the `200` status
  - removed the optional property `registries/items/auth_status` from the response with the `200` status
  - removed the optional property `registries/items/auth_type` from the response with the `200` status

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