---
title: "List catalogs"
method: GET
path: "/catalogs"
tags: ["Catalogs"]
---

# List catalogs

`GET /catalogs`

Lists the available catalogs. There is no guarantee of a specific ordering of the elements in the list.

## Query parameters

- `page_token` string
- `max_results` integer

## Response `200`

The catalog list was successfully retrieved.

- ListCatalogsResponse
  - `catalogs` CatalogInfo[] — An array of catalog information objects.
    - `name` string — Name of catalog.
    - `comment` string — User-provided free-form text description.
    - `properties` SecurablePropertiesMap — A map of key-value properties attached to the securable.
    - `created_at` integer — Time at which this catalog was created, in epoch milliseconds.
    - `updated_at` integer — Time at which this catalog was last modified, in epoch milliseconds.
    - `id` string — Unique identifier for the catalog.
  - `next_page_token` string — Opaque token to retrieve the next page of results. Absent if there are no more pages. __page_token__ should be set to this value for the next request (for the next page of results).

---

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