---
title: "List schemas"
method: GET
path: "/schemas"
tags: ["Schemas"]
---

# List schemas

`GET /schemas`

Gets an array of schemas for a catalog.
There is no guarantee of a specific ordering of the elements in the array.

## Query parameters

- `catalog_name` string, required
- `max_results` integer
- `page_token` string

## Response `200`

The schemas list was successfully retrieved.

- ListSchemasResponse
  - `schemas` SchemaInfo[] — An array of schema information objects.
    - `name` string — Name of schema, relative to parent catalog.
    - `catalog_name` string — Name of parent catalog.
    - `comment` string — User-provided free-form text description.
    - `properties` SecurablePropertiesMap — A map of key-value properties attached to the securable.
    - `full_name` string — Full name of schema, in form of __catalog_name__.__schema_name__.
    - `created_at` integer — Time at which this schema was created, in epoch milliseconds.
    - `updated_at` integer — Time at which this schema was last modified, in epoch milliseconds.
    - `schema_id` string — Unique identifier for the schema.
  - `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)