Get company research rows

View research records for a company through tables owned by your organization.

GET/api/companies/{company_id}/rows

HTTP referenceScope companies:readUpdated September 28, 2026

This page documents the canonical HTTP contract for this endpoint.

Requires companies:read. The handler first verifies that the company belongs to your authenticated organization, then returns only linked research rows whose table is also owned by that organization. Rows and table names are organization-scoped. The response may include additional row fields; the example is abbreviated.

Path parameters

company_idrequired
string
Company ID in your organization.

Name	Type	Description
company_idrequired	string	Company ID in your organization.

Errors

Status	Meaning
400	Organization context is missing or company_id is invalid.
401	Missing or invalid authentication.
403	Developer key lacks companies:read.
404	Company is not found in the authenticated organization.

Example

bash

curl "https://app.autotouch.ai/api/companies/67c4b113b4dd8f2d4999f0f1/rows" -H "Authorization: Bearer $AUTOTOUCH_API_KEY"

Response example

json

{"company_id":"67c4b113b4dd8f2d4999f0f1","company_name":"Acme","company_domain":"acme.example","rows":[{"id":"67c4b113b4dd8f2d4999f0f2","company_id":"67c4b113b4dd8f2d4999f0f1","table_id":"67c4b113b4dd8f2d4999f0f3","table_name":"Q3 target accounts","created_at":"2026-09-28T14:00:00Z"}],"total":1,"table_summary":[{"table_name":"Q3 target accounts","row_count":1,"last_updated":"2026-09-28T14:00:00Z"}],"linked_company_ids":["67c4b113b4dd8f2d4999f0f1"]}