Stay organized with collections
Save and categorize content based on your preferences.
You can list the schema registries in your project. This document shows you
how to list schema registries using the
Google Cloud console, the Google Cloud CLI, or the Managed Kafka API.
This predefined role contains
the permissions required to list schema registries. To see the exact permissions that are
required, expand the Required permissions section:
Required permissions
The following permissions are required to list schema registries:
Grant the following permission on the parent location:
managedkafka.schemaRegistries.list
Higher-level roles like Managed Kafka Schema Registry Editor
(roles/managedkafka.schemaRegistryEditor) and
Managed Kafka Schema Registry Admin (roles/managedkafka.schemaRegistryAdmin)
also lets you list schema registries.
To list schema registries using the REST API, perform the following steps.
Make a GET request to the schema registries collection URI for the
required project and location.
GET https://managedkafka.googleapis.com/v1main/projects/PROJECT_ID/locations/LOCATION/schemaRegistries
Authorization: Bearer $(gcloud auth application-default print-access-token)
Replace the following:
PROJECT_ID (required): your Google Cloud project ID.
LOCATION (required): the Google Cloud region where you want to list
the schema registries.
If the request is successful, the API returns a 200 OK status code.
The response body contains a JSON object. This object includes a list of
schema registry resources found in the specified location.
The list schema registry call returns an empty context
field even in cases where the schema registry contains a context. To get the
list of contexts for a schema registry, you can run the
get schema registry API call.
For more information about the REST API calls, see the
REST API documentation.
Apache Kafka® is a registered
trademark of The Apache Software Foundation or its affiliates in the United
States and/or other countries.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[],[],null,["# List all schema registries\n\n| **Preview**\n|\n|\n| This product or feature is subject to the \"Pre-GA Offerings Terms\" in the General Service Terms section\n| of the [Service Specific Terms](/terms/service-terms#1).\n|\n| Pre-GA products and features are available \"as is\" and might have limited support.\n|\n| For more information, see the\n| [launch stage descriptions](/products#product-launch-stages).\n\nYou can list the schema registries in your project. This document shows you\nhow to list schema registries using the\nGoogle Cloud console, the Google Cloud CLI, or the Managed Kafka API.\n\n### Required roles and permissions\n\n\nTo get the permissions that\nyou need to list schema registries,\n\nask your administrator to grant you the\n\n\n[Managed Kafka Schema Registry Viewer](/iam/docs/roles-permissions/managedkafka#managedkafka.schemaRegistryViewer) (`roles/managedkafka.schemaRegistryViewer`)\nIAM role on your project and location.\n\n\nFor more information about granting roles, see [Manage access to projects, folders, and organizations](/iam/docs/granting-changing-revoking-access).\n\n\nThis predefined role contains\n\nthe permissions required to list schema registries. To see the exact permissions that are\nrequired, expand the **Required permissions** section:\n\n\n#### Required permissions\n\nThe following permissions are required to list schema registries:\n\n- Grant the following permission on the parent location: ` ``managedkafka.schemaRegistries.list`\n\n\nYou might also be able to get\nthese permissions\nwith [custom roles](/iam/docs/creating-custom-roles) or\nother [predefined roles](/iam/docs/roles-overview#predefined).\n\nHigher-level roles like **Managed Kafka Schema Registry Editor**\n(`roles/managedkafka.schemaRegistryEditor`) and\n**Managed Kafka Schema Registry Admin** (`roles/managedkafka.schemaRegistryAdmin`)\nalso lets you list schema registries.\n\nFor more information about predefined roles, see the\n[Managed Service for Apache Kafka predefined roles](/managed-service-for-apache-kafka/docs/access-control#predefined-roles).\n\nList your schema registries\n---------------------------\n\nTo list all your schema registries within your project, follow these steps. \n\n### Console\n\n1. In the Google Cloud console, go to the **Schema registries** page.\n\n [Go to schema registries](https://console.cloud.google.com/managedkafka/schemaRegistries)\n\n The page displays a list of schema registries in your project. The list\n includes columns for the following properties:\n - **Name**: the unique identifier for the schema registry.\n - **Region**: the Google Cloud region where the schema registry is hosted.\n\n### gcloud\n\n1.\n [Install](/sdk/docs/install) the Google Cloud CLI.\n\n After installation,\n [initialize](/sdk/docs/initializing) the Google Cloud CLI by running the following command:\n\n ```bash\n gcloud init\n ```\n\n\n If you're using an external identity provider (IdP), you must first\n [sign in to the gcloud CLI with your federated identity](/iam/docs/workforce-log-in-gcloud).\n2. Run the [`gcloud beta managed-kafka schema-registries list`](/sdk/gcloud/reference/beta/managed-kafka/schema-registries/list) command: \n\n```bash\ngcloud beta managed-kafka schema-registries list \\\n --location=LOCATION \\\n```\n3. Replace the following:\n - \u003cvar translate=\"no\"\u003eLOCATION\u003c/var\u003e (required): the Google Cloud region for which to list schema registries.\n4. For example, to list all schema registries in the `us-central1` location, run the following command: \n\n```bash\ngcloud beta managed-kafka schema-registries list --location=us-central1\n```\n5. Sample output: \n\n```bash\nNAME LOCATION\nsr_docs us-central1\nsr_docs23 us-central1\nsr23wert us-central1\n```\n\n### REST\n\nTo list schema registries using the REST API, perform the following steps.\n\n1. Make a `GET` request to the schema registries collection URI for the required project and location. \n\n```\nGET https://managedkafka.googleapis.com/v1main/projects/PROJECT_ID/locations/LOCATION/schemaRegistries\nAuthorization: Bearer $(gcloud auth application-default print-access-token)\n```\n2. Replace the following:\n - \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e (required): your Google Cloud project ID.\n - \u003cvar translate=\"no\"\u003eLOCATION\u003c/var\u003e (required): the Google Cloud region where you want to list the schema registries.\n\n\u003cbr /\u003e\n\nIf the request is successful, the API returns a `200 OK` status code.\nThe response body contains a JSON object. This object includes a list of\nschema registry resources found in the specified location.\n\nThe following is a sample successful response: \n\n```json\n{\n \"schemaRegistries\": [\n {\n \"name\": \"projects/schema-test-project/location/us-central1/schemaRegistries/sr_docs\",\n \"contexts\": []\n },\n {\n \"name\": \"projects/schema-test-project/location/us-central1/schemaRegistries/moi_sr_docs23\",\n \"contexts\": []\n },\n {\n \"name\": \"projects/schema-test-project/location/us-central1/schemaRegistries/sr23wert\",\n \"contexts\": []\n }\n ]\n}\n```\n\nThe `list schema registry` call returns an empty context\nfield even in cases where the schema registry contains a context. To get the\nlist of contexts for a schema registry, you can run the\n[`\nget schema registry`](/managed-service-for-apache-kafka/docs/reference/rest/v1/projects.locations.schemaRegistries/get) API call.\nFor more information about the REST API calls, see the\n[REST API documentation](/managed-service-for-apache-kafka/docs/reference/rest).\n\n\u003cbr /\u003e\n\n*Apache Kafka® is a registered\ntrademark of The Apache Software Foundation or its affiliates in the United\nStates and/or other countries.*"]]