---
title: "List events for a table"
method: GET
path: "/v2/storage/tables/{tableId}/events"
tags: ["Tables"]
---

# List events for a table

`GET /v2/storage/tables/{tableId}/events`

## Request

- Base URL: `https://connection.keboola.com`
- URL: `https://connection.keboola.com/v2/storage/tables/{tableId}/events`
- Auth: one of:
  - API key in header `X-StorageApi-Token`
  - API key in header `X-KBC-ManageApiToken`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/keboola/apis/keboola-storage-api/docs/v2/storage/tables/:tableId/events/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a list of events for the specified table.

## Path parameters

- `tableId` string, required

## Query parameters

- `limit` integer
- `offset` integer
- `maxId` string
- `sinceId` string
- `component` string
- `configurationId` string
- `runId` string
- `q` string
- `query` string
- `sortOrder` 'asc' | 'desc'

## Response `200`

Table events list response

- TableEventResponse[]
  - `uuid` string, required: Unique identifier of the event.
  - `event` string, required: Name of the event.
  - `message` string, required: Event message.
  - `description` string, required: Event description.
  - `type` 'info' | 'success' | 'warn' | 'error', required: Type of the event.
  - `component` string, required: Component name.
  - `runId` string, nullable, required: Run ID of the event.
  - `configurationId` string, nullable, required: Configuration ID associated with the event.
  - `objectId` string, required: ID of the object the event relates to.
  - `objectName` string, required: Name of the object the event relates to.
  - `objectType` string, required: Type of the object the event relates to.
  - `idBranch` integer, nullable, required: ID of the branch the event belongs to; `null` when the event is not tied to a branch.
  - `token` object, required: Token that produced the event.
    - `id` integer, required: Token ID.
    - `name` string, nullable, required: Token name.
  - `context` union, required: Request context the event was created in; an empty array `[]` when the event has no context.
    - object
      - `httpUserAgent` string, nullable: User agent of the request.
      - `authorization` string: Authorization type of the request.
      - `httpUserAgentOriginal` string, nullable: Original user agent of the request. Present only when the request sent `X-User-Agent`.
      - `httpReferer` string, nullable: Referer of the request.
      - `remoteAddr` string, nullable: Remote address of the request.
      - `apiVersion` string: API version of the request or of the job that raised the event.
      - `userAgent` string: User agent of the request that created the job. Present only on events raised by a job.
      - `async` boolean: Always `true`. Present only on events raised by a job.
    - unknown[]
      - unknown
  - `created` string, required: Event creation timestamp, ISO 8601 with a `+hhmm` offset; `""` when none was recorded.
  - `uri` string, required: Link to the event details.
  - `params` object, required: Event parameters.
  - `results` object, required: Event results.
  - `performance` object, required: Event performance metrics.
  - `attachments` TableEventAttachmentResponse[], required: Files attached to the event.
    - `id` integer, required: Attachment file ID.
    - `isSliced` boolean, required: Whether the file is sliced.
    - `uploadType` string, required: Upload type of the file.
    - `isExpired` boolean, required: Whether the file is expired.
    - `created` string, required: Attachment creation timestamp, ISO 8601 with a `+hhmm` offset.
    - `name` string, required: Attachment file name.
    - `url` string, required: Attachment download URL.
    - `sizeBytes` integer, nullable, required: Attachment file size in bytes.

## Other responses

- `400`: Returned when the provided events filter parameters are invalid.
- `403`: Access denied to the table.
- `404`: Returned when the table or bucket is not found.
- `503`: Bucket or its backend connection is under maintenance.

---

[API](https://skmtc.dev/keboola/apis/keboola-storage-api.md) - [All operations](https://skmtc.dev/keboola/apis/keboola-storage-api/llms.txt) - [OpenAPI document](https://skmtc.dev/keboola/apis/keboola-storage-api/revisions/34b5ceac0317?raw)