---
title: "List Tables"
method: GET
path: "/api/public/v2/tables"
tags: ["smart-tables"]
---

# List Tables

`GET /api/public/v2/tables`

List Tables in the workspace. Supports cursor-based pagination and optional filtering by folder or prompt column. Requests are scoped to the workspace associated with the API key; table, sheet, column, cell, operation, and version IDs must belong to that workspace.

## Query parameters

- `folder_id` integer — Filter by folder ID.
- `name` string — Filter by title (case-insensitive contains match).
- `cursor` string — Pagination cursor from a previous response.
- `limit` integer
- `order` 'asc' | 'desc'
- `prompt_id` integer — Filter to tables containing a column referencing this prompt.
- `prompt_version_id` integer
- `prompt_label_id` integer

## Response `200`

List of tables

- object
  - `data` Table[]
    - `id` string, uuid — Unique table identifier.
    - `workspace_id` integer — Workspace that owns this resource; determined by the authenticated request scope.
    - `title` string
    - `folder_id` integer, nullable
    - `sheet_count` integer — Number of active sheets.
    - `created_at` string, date-time
    - `updated_at` string, date-time
  - `next_cursor` string, nullable
  - `has_more` boolean

## Other responses

- `401` — Unauthorized - missing or invalid API key.
- `422` — Validation error - request parameters or body are invalid.

---

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