---
title: "List Source Tables"
method: GET
path: "/v1/source_tables"
tags: ["source_table"]
---

# List Source Tables

`GET /v1/source_tables`

## Query parameters

- `cursor` string, nullable
- `size` integer

## Response `200`

Successful Response

- CursorPageSourceTableResponseCustomized
  - `items` SourceTableResponse[], required
    - `catalog_name` string
    - `schema_name` string
    - `table_name` string, required
    - `location` SourceTableProviderManifestOutput, required
      - `table_paths` ListingTableUrlConfig[], required
      - `file_schema` ArrowSchemaConfigOutput
      - `options` ListingOptionsConfigOutput
        - `format` union, required
          - CsvFileFormatConfig
            - `kind` 'csv'
            - `config` CsvFormatConfig
              - …
          - JsonFileFormatConfig
            - `kind` 'json'
            - `config` JsonFormatConfig
              - …
          - ParquetFileFormatConfig
            - `kind` 'parquet'
            - `config` ParquetFormatConfig
              - …
        - `file_extension` string, nullable
        - `table_partition_cols` array[]
          - unknown[]
            - unknown
        - `collect_stat` boolean
        - `target_partitions` integer
      - `kind` 'listing'
    - `id` string, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `total` integer, nullable
  - `current_page` string, nullable — Cursor to refetch the current page
  - `current_page_backwards` string, nullable — Cursor to refetch the current page starting from the last item
  - `previous_page` string, nullable — Cursor for the previous page
  - `next_page` string, nullable — Cursor for the next page

## Other responses

- `422` — Validation Error

## Changes

- **2026-07-26** `17afb53a6ac9` — 1 breaking, 10 info
  - removed the required property `source_tables` from the response with the `200` status
  - api tag `source_table` added
  - api tag `source_tables` removed
  - added the new optional `query` request parameter `cursor`
  - …7 more

[Change history](https://skmtc.dev/outerproduct/apis/outerproduct-api/changes/v1/source_tables/get.md)

---

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