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

# GET /catalogs

`GET /catalogs`

List catalogs

 Gets an array of catalogs in the metastore. If the caller is the metastore admin,
 all catalogs will be retrieved. Otherwise, only catalogs owned by the caller
 (or for which the caller has the USE_CATALOG privilege) will be retrieved.
 There is no guarantee of a specific ordering of the elements in the array.

## Query parameters

- `maxResults` integer
- `pageToken` string

## Response `200`

OK

- ListCatalogsResponse — List catalogs response.
  - `catalogs` CatalogInfo[] — The catalogs returned.
    - `id` string — Unique identifier for the catalog.
    - `name` string — Name of catalog.
    - `owner` string — Username of current owner of catalog.
    - `comment` string — User-provided free-form text description.
    - `properties` object — A map of key-value properties attached to the securable.
    - `storageRoot` string — Storage root URL for managed tables within catalog.
    - `providerName` string — The name of delta sharing provider. A Delta Sharing catalog is a catalog that is based on a Delta share on a remote sharing server.
    - `shareName` string — The name of the share under the share provider.
    - `catalogType` integer — The type of the catalog.
    - `createdAt` string — Time at which this catalog was created, in epoch milliseconds.
    - `createdBy` string — Username of catalog creator.
    - `updatedAt` string — Time at which this catalog was last updated, in epoch milliseconds.
    - `updatedBy` string — Username of user who last modified catalog.
    - `browseOnly` boolean — Indicates whether the principal is limited to retrieving metadata for the associated object through the BROWSE privilege when include_browse is enabled in the request.
  - `nextPageToken` string — The next_page_token value to include in the next List request.

## Other responses

- `default` — Default error response

---

[API](https://skmtc.net/delta-incubator/apis/delta-sharing-api.md) · [All operations](https://skmtc.net/delta-incubator/apis/delta-sharing-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/delta-incubator/delta-sharing-api/versions/a47a0389fffc/schema)