List companies in a research table

This page documents the canonical HTTP contract for this endpoint.

The response example is abridged. Company objects include computed and organization-specific fields; use the CRM field catalog for field discovery. The normal populated-table response includes total, rows_with_companies, has_more and next_offset; when the table has no company rows, the early empty response omits limit, offset, has_more and next_offset. Other server failures may return 500.

Path parameters

table_idrequired
string
Research table identifier.

Name	Type	Description
table_idrequired	string	Research table identifier.

Query parameters

owner_id · optional
string
Filter by company owner.
search · optional
string
Search company workspace records.
filters · optional
string
JSON-encoded company filter rules.
sort · optional
string
Workspace sort field.
order · optional
string
Sort order.
limit · optional
integer
Page size.
offset · optional
integer
Rows to skip.

Name	Type	Description
owner_id	string	Filter by company owner.
search	string	Search company workspace records.
filters	string	JSON-encoded company filter rules.
sort	string	Workspace sort field.
order	string	Sort order.
limit	integer	Page size.
offset	integer	Rows to skip.

Errors

Status	Meaning
401	Authentication is missing or invalid.
403	The credential is invalid or lacks the required scope.
400	Company filters or query parameters are invalid.
503	The query or required search index is temporarily unavailable.
500	An unexpected company-query failure occurred.

Example

bash

curl -G "https://app.autotouch.ai/api/companies/table/67c4a4f7b4dd8f2d4999f014" \
  -H "Authorization: Bearer $AUTOTOUCH_API_KEY" \
  --data-urlencode "limit=100" \
  --data-urlencode "offset=0"

Response example

json

{
  "companies": [
    {
      "_id": "67c4a4f7b4dd8f2d4999f014",
      "name": "Example Company",
      "domain": "example.test",
      "research_data": {
        "employee_count": 50
      }
    }
  ],
  "total": 1,
  "rows_with_companies": 1,
  "table_id": "table-id",
  "limit": 500,
  "offset": 0,
  "has_more": false,
  "next_offset": null
}