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

Documentation Index

Fetch the complete documentation index at: https://help.teable.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
baseId
string
required
​
tableId
string
required

Response

200 - application/json

Returns data about a table.

​
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