Get table

Retrieve one table with its columns, all matching rows, and cell status; response is unpaginated.

GET/api/tables/{table_id}

HTTP referenceScope tables:readUpdated September 27, 2026

This page documents the canonical HTTP contract for this endpoint.

This response includes every matching row and does not paginate. Use the rows endpoint for large tables. Its response model contains only id, name, columns, rows, and cellStatus; metadata is omitted.

Path parameters

table_idrequired
string
The table ID.

Name	Type	Description
table_idrequired	string	The table ID.

Query parameters

filters · optional
string
JSON-encoded filter object to restrict rows (filters[] with columnKey/operator, optional columnId/jsonPath/value/value2, mode and/or); jsonPath requires columnId. Invalid JSON returns 400.

Name	Type	Description
filters	string	JSON-encoded filter object to restrict rows (filters[] with columnKey/operator, optional columnId/jsonPath/value/value2, mode and/or); jsonPath requires columnId. Invalid JSON returns 400.

Errors

Status	Meaning
400	Invalid filter JSON.
401	Authentication required.
403	Access denied.
404	Table not found.
410	Table is being deleted.

Example

bash

curl -X GET "https://app.autotouch.ai/api/tables/67bd8c39c7d3e80f0a95b560" \
  -H "Authorization: Bearer stk_your_key_id.your_secret"

Response example

json

{
  "id": "67bd8c39c7d3e80f0a95b560",
  "name": "GitHub Prospects - Q1",
  "columns": [{"id": "67bd8c39c7d3e80f0a95b561", "key": "company_name", "label": "Company name"}, {"id": "67bd8c39c7d3e80f0a95b562", "key": "website", "label": "Website"}],
  "rows": [
    {
      "_id": "67bd8c39c7d3e80f0a95b563",
      "table_id": "67bd8c39c7d3e80f0a95b560",
      "position": 0,
      "company_name": "Acme Corp",
      "website": "acme.com"
    }
  ],
  "cellStatus": {}
}