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

# List Catalogs

`GET /v1/catalogs`

Returns a list of all registered catalogs (data sources). Catalogs provide metadata about schemas and tables available from external data sources.

## Query parameters

- `from` string, nullable

## Response `200`

List of catalogs

- CatalogInfo[]
  - `from` string, required — The source/provider of the catalog (e.g., `spiceai`, `unity`)
  - `name` string, required — The name of the catalog

## Other responses

- `500` — Internal server error occurred while processing catalogs

## Changes

> 53 revisions in range; 26 could not be searched.

- **2025-03-18** `dd94571fef79` — 1 breaking, 4 info
  - the response's body type/format changed from `array`/`` to `object`/`` for status `200`
  - api tag `Datasets` added
  - api tag `Catalogs` removed
  - added the required property `from` to the response with the `200` status
  - …1 more

[Change history](https://skmtc.dev/spiceai/apis/runtime/changes/v1/catalogs/get.md)

---

[API](https://skmtc.dev/spiceai/apis/runtime.md) · [All operations](https://skmtc.dev/spiceai/apis/runtime/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/spiceai/runtime/revisions/fb597a4eaa56/schema)
