Skip to main content
GET
/
base
/
{baseId}
/
table
cURL
curl --request GET \
  --url https://app.teable.ai/api/base/%7BbaseId%7D/table \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'
[
  {
    "id": "<string>",
    "name": "<string>",
    "dbTableName": "<string>",
    "description": "<string>",
    "icon": "<string>",
    "order": 123,
    "lastModifiedTime": "<string>",
    "defaultViewId": "<string>"
  }
]

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
baseId
string
required

Response

200 - application/json

Successfully retrieved the list of tables.

​
id
string
required

The id of table.

​
name
string
required

The name of the table.

​
dbTableName
string
required

Table name in backend database. Limitation: 1-63 characters, start with letter, can only contain letters, numbers and underscore, case insensitive, cannot be duplicated with existing db table name in the base.

Pattern: ^[a-z]\w{0,62}$/i
​
description
string

The description of the table.

​
icon
string<emoji>

The emoji icon string of the table.

​
order
number
​
lastModifiedTime
string

The last modified time of the table.

​
defaultViewId
string

The default view id of the table.

Last modified on March 5, 2026