---
title: "List tables"
method: GET
path: "/docs/{docId}/tables"
tags: ["Tables"]
---

# List tables

`GET /docs/{docId}/tables`

Returns a list of tables in a document.

## Path parameters

- `docId` string, required

## Query parameters

- `limit` integer
- `pageToken` string
- `sortBy` 'name' — Determines how the objects returned are sorted
- `tableTypes` TableType[]

## Response `200`

List of tables or views in a doc.

- TableList — List of tables.
  - `items` TableReference[], required
    - `id` string, required — ID of the table.
    - `type` 'table', required — The type of this resource.
    - `tableType` 'table' | 'view' | 'database', required
    - `href` string, url, required — API link to the table.
    - `browserLink` string, url, required — Browser-friendly link to the table.
    - `name` string, required — Name of the table.
    - `parent` PageReference — Reference to a page.
      - `id` string, required — ID of the page.
      - `type` 'page', required — The type of this resource.
      - `href` string, url, required — API link to the page.
      - `browserLink` string, url, required — Browser-friendly link to the page.
      - `name` string, required — Name of the page.
  - `href` string, url — API link to these results
  - `nextPageToken` string — If specified, an opaque token used to fetch the next page of results.
  - `nextPageLink` string, url — If specified, a link that can be used to fetch the next page of results.

## Other responses

- `401` — The API token is invalid or has expired.
- `403` — The API token does not grant access to this resource.
- `404` — The resource could not be located with the current API token.
- `429` — The client has sent too many requests.

---

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