---
title: "ListTables"
method: GET
path: "/v1alpha/catalogs/{catalogId}/tables"
tags: ["DataCatalogsService"]
---

# ListTables

`GET /v1alpha/catalogs/{catalogId}/tables`

Lists all tables (for a given schema and database, if applicable).

## Path parameters

- `catalogId` string, required

## Query parameters

- `databaseId` string
- `schemaId` string
- `pageParameters.skip` integer
- `pageParameters.pageSize` integer
- `pageParameters.pageToken` string

## Response `200`

OK

- ListTablesResponse
  - `pageInfo` PageInfo
    - `nextPageToken` string — token for the next page
    - `total` integer — The (estimated) total number of records. If the total is unknown, this value is -1.
  - `tables` Table[]
    - `id` string — The id used by the catalog.
    - `name` string
    - `schema` Schema
      - `database` Database
        - `catalog` DataCatalog
          - `databases` Database[] — A top-most level of the catalog. This is typically a database.
          - `id` string — An arbitrary but unique identifier for the catalog. This matches the id from the PACE app configuration.
          - `tags` string[]
          - `type` 'TYPE_UNSPECIFIED' | 'COLLIBRA' | 'ODD' | 'DATAHUB', enum
        - `displayName` string
        - `id` string — The id of the database
        - `processingPlatform` ProcessingPlatform
          - `id` string — An arbitrary but unique identifier for the platform. This matches the id from the PACE app configuration.
          - `platformType` 'PLATFORM_TYPE_UNSPECIFIED' | 'DATABRICKS' | 'SNOWFLAKE' | 'BIGQUERY' | 'POSTGRES' | 'SYNAPSE', enum
        - `schemas` Schema[] — The schemas in this database.
        - `tags` string[]
        - `type` string
      - `id` string — The id used by the catalog.
      - `name` string
      - `tables` Table[] — The tables in this schema.
      - `tags` string[]
    - `tags` string[]

## Other responses

- `default` — Default error response

## Changes

- **2024-01-26** `12ea67ec598f` — 2 info
  - added the new optional `query` request parameter `pageParameters.pageToken`
  - added the optional property `pageInfo/nextPageToken` to the response with the `200` status
- **2024-01-12** `fece62c921d3` — 2 info
  - added `#/components/schemas/Schema` to the `tables/items/schema` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/DataCatalog_Schema` from the `tables/items/schema` response property `allOf` list for the response status `200`
- **2024-01-08** `a00039bf1f21` — 2 info
  - added `#/components/schemas/DataCatalog_Schema` to the `tables/items/schema` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/Schema` from the `tables/items/schema` response property `allOf` list for the response status `200`
- **2024-01-05** `c17254898ea0` — 2 info
  - added `#/components/schemas/Schema` to the `tables/items/schema` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/DataCatalog_Schema` from the `tables/items/schema` response property `allOf` list for the response status `200`
- **2023-12-19** `df7ee7e702db` — 3 info
  - added the new optional `query` request parameter `pageParameters.pageSize`
  - added the new optional `query` request parameter `pageParameters.skip`
  - added the optional property `pageInfo` to the response with the `200` status

[Full history](https://skmtc.dev/getstrm/apis/pace-api/changes/v1alpha/catalogs/:catalogId/tables/get.md)

---

[API](https://skmtc.dev/getstrm/apis/pace-api.md) · [All operations](https://skmtc.dev/getstrm/apis/pace-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getstrm/pace-api/revisions/7102a90e7c1e/schema)