Skip to main content
GET
/
api
/
v2
/
public
/
tables
/
:table_id
curl -X GET "https://app.refold.ai/api/v2/public/tables/{table_id}?limit=10" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "linked_account_id: YOUR_LINKED_ACCOUNT_ID"

{
  "name": "leads",
  "columns": ["email", "stage"],
  "docs": [
    { "record_id": "02cd01ca-c09f-4f91-893d-222ab529f585", "email": "jane@example.com", "stage": "new" },
    { "record_id": "166047e8-f290-416b-ab4c-0fd03119d9f6", "email": "john@example.com", "stage": "qualified" }
  ],
  "page": 1,
  "limit": 10,
  "totalDocs": 2,
  "totalPages": 1,
  "hasNextPage": false
}
Return the records in a persistent table, paginated, along with the table’s column list.

​
Authentication

​
x-api-key
string
required
Your Refold API key.
​
linked_account_id
string
required
The linked account that owns the table.

​
Path Parameters

​
table_id
string
required
The table ID.

​
Query Parameters

​
page
integer
default:"1"
Page number.
​
limit
integer
default:"10"
Rows per page.

​
Response

​
name
string
Table name.
​
columns
array
Column names.
​
docs
array
Records, each keyed by column plus a record_id.
​
totalDocs
integer
Total records.
​
page
integer
Current page.
​
hasNextPage
boolean
Whether another page follows.
{
  "name": "leads",
  "columns": ["email", "stage"],
  "docs": [
    { "record_id": "02cd01ca-c09f-4f91-893d-222ab529f585", "email": "jane@example.com", "stage": "new" },
    { "record_id": "166047e8-f290-416b-ab4c-0fd03119d9f6", "email": "john@example.com", "stage": "qualified" }
  ],
  "page": 1,
  "limit": 10,
  "totalDocs": 2,
  "totalPages": 1,
  "hasNextPage": false
}

curl -X GET "https://app.refold.ai/api/v2/public/tables/{table_id}?limit=10" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "linked_account_id: YOUR_LINKED_ACCOUNT_ID"