List table event streams

List the authenticated organization’s event-stream definitions, optionally limited to one accessible research table.

GET/api/table-event-streams

HTTP referenceScope tables:readUpdated September 27, 2026

This page documents the canonical HTTP contract for this endpoint.

Developer API keys need the listed scope. A valid authenticated user session may also call this route.

The server caps this list at 200 records, ordered by most recently updated. The response example is abbreviated; identifiers and timestamps are illustrative.

Query parameters

table_id · optional
string
Optional table identifier; when supplied, the caller must have access to that table.

Name	Type	Description
table_id	string	Optional table identifier; when supplied, the caller must have access to that table.

Errors

Status	Meaning
401	Authentication is missing or invalid.
403	The credential is invalid or lacks the required scope, or the caller cannot access the resource.
403	The caller cannot access the requested table.
404	The table does not exist.
410	The table is being deleted.

Example

bash

curl -G "https://app.autotouch.ai/api/table-event-streams" \
  -H "Authorization: Bearer $AUTOTOUCH_API_KEY" \
  --data-urlencode "table_id=table-id"

Response example

json

{
  "items": [
    {
      "id": "event-stream-id",
      "table_id": "table-id",
      "name": "Hiring signals",
      "status": "active",
      "subject_type": "company",
      "identity": {
        "kind": "company_domain",
        "column_key": "domain"
      },
      "updated_at": "2026-09-27T12:00:00"
    }
  ]
}