---
title: "List a table’s activity"
method: GET
path: "/v1/tables/{tableId}/events"
tags: ["Tables"]
---

# List a table’s activity

`GET /v1/tables/{tableId}/events`

## Request

- Base URL: `https://api.banksync.io`
- URL: `https://api.banksync.io/v1/tables/{tableId}/events`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

The audit trail: who inserted, edited, deleted, restored or purged rows, which schema changes landed, and which feed sync wrote a batch — newest first, keyset-paginated. Filter to one `rowId` to answer "what happened to this record", or to one `event` type. This is how an integration reconciles what it wrote against what the workspace actually holds.

## Path parameters

- `tableId` string, required: Table ID

## Query parameters

- `cursor` string
- `limit` integer
- `rowId` string
- `event` 'insert' | 'update' | 'delete' | 'restore' | 'purge' | 'sync_batch' | 'import_batch' | 'schema_change' | 'comment' | 'message'

## Response `200`

Page of events

- object
  - `success` true, required
  - `data` object[], required
    - `id` string, required
    - `workspaceId` string, required
    - `tableId` string, required
    - `rowId` string
    - `event` 'insert' | 'update' | 'delete' | 'restore' | 'purge' | 'sync_batch' | 'import_batch' | 'schema_change' | 'comment' | 'message', required
    - `actor` union, required
      - object
        - `kind` 'user', required
        - `userId` string, required
      - object
        - `kind` 'sync', required
        - `feedId` string, required
        - `jobId` string
        - `cause` object
          - `automationId` string, required
          - `runId` string, required
          - `depth` integer, required
          - `untrustedSender` true
      - object
        - `kind` 'extractor', required
        - `feedId` string, required
        - `jobId` string
        - `untrustedSender` true
      - object
        - `kind` 'import', required
        - `importId` string, required
        - `userId` string, required
      - object
        - `kind` 'api', required
        - `clientId` string, required
      - object
        - `kind` 'system', required
        - `reason` string, required
      - object
        - `kind` 'automation', required
        - `automationId` string, required
        - `revision` string, required
        - `grantId` string, required
        - `runId` string, required
        - `node` string, required
        - `startedBy` ActorRef, required (recursive)
        - `depth` integer, required
        - `untrustedSender` true
    - `changed` object
    - `batch` object
      - `jobId` string
      - `importId` string
      - `inserted` integer
      - `updated` integer
      - `deleted` integer
      - `skipped` integer
    - `at` string, required
  - `meta` object, required
    - `count` integer, required
    - `cursor` string, nullable, required
    - `hasMore` boolean, required

## Other responses

- `400`: Validation failed, or a read-only field was written — `code` names the refusal and `details[]` the offending field or cell
- `401`: Unauthorized
- `403`: Forbidden — missing scope, insufficient role, or plan limit reached
- `404`: Not found

---

[API](https://skmtc.dev/banksync/apis/banksync-api.md) · [All operations](https://skmtc.dev/banksync/apis/banksync-api/llms.txt) · [OpenAPI document](https://skmtc.dev/banksync/apis/banksync-api/revisions/94465f5ee922?raw)