Get table field meanings

Read field meanings, supported options, person groups, source revisions, and the mapping version.

GET/api/tables/{table_id}/field-meanings

Scope tables:readUpdated October 15, 2026

This page documents the canonical HTTP contract. Switch to the CLI example when you want the operator workflow.

This catalog contains existing scalar fields and their exact column_id, path, and source_revision. Choose a supported value from options; preserve person groups and collection paths when interpreting nested data. Saving a correction changes field meaning metadata and setup suggestions; it does not run enrichment or write CRM records.

Path parameters

table_idrequired
string
Accessible Research Table ID.

Name	Type	Description
table_idrequired	string	Accessible Research Table ID.

Errors

Status	Meaning
401	Authentication required.
403	tables:read or table access is missing.
404	Table not found.

Example

bash

curl -X GET "https://app.autotouch.ai/api/tables/67bd8c39c7d3e80f0a95b560/field-meanings" \
  -H "Authorization: Bearer $AUTOTOUCH_API_KEY"

Response example

json

{
  "fields": [
    {
      "column_id": "67bd8cd8c7d3e80f0a95b58f",
      "column_label": "Company website",
      "path": "",
      "source_revision": "source-revision-example",
      "semantic_type": "company_domain",
      "automatic_semantic_type": "company_domain",
      "override": null,
      "availability": "observed",
      "mapped": true,
      "editable": true,
      "cardinality": "one",
      "origin": "observed",
      "collection_paths": [],
      "entity_group": null
    }
  ],
  "person_groups": [],
  "options": [
    {
      "value": "company_domain",
      "label": "Company domain"
    }
  ],
  "mapping_version": 0
}