---
title: "Stats detail"
method: GET
path: "/v2/storage/stats"
tags: ["Stats"]
---

# Stats detail

`GET /v2/storage/stats`

## Request

- Base URL: `https://connection.keboola.com`
- URL: `https://connection.keboola.com/v2/storage/stats`
- 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/stats/get.ts> (a function with typed inputs; its response is checked against the schema)

Gets stats for a given Run Id. Provides the count of imported/exported tables and files in a specified run with durations.

## Query parameters

- `runId` string, required: Id of the run to list stats for.

## Response `200`

Statistics for the run.

- StatsListResponse: Import/export statistics of tables and files for a run ID.
  - `tables` object, required: Table import and export statistics aggregated from storage events.
    - `import` object, required
      - `totalCount` integer, required: Total number of import events in the run.
      - `tables` object[], required
        - `id` string, required: Table ID.
        - `count` integer, required
        - `durationTotalSeconds` number, float, required
    - `export` object, required
      - `totalCount` integer, required: Total number of export events in the run.
      - `tables` object[], required
        - `id` string, required: Table ID.
        - `count` integer, required
        - `durationTotalSeconds` number, float, required
  - `files` object, required: File upload statistics.
    - `total` object, required
      - `count` integer, required: Number of files in the run.
      - `dataSizeBytes` object, required
        - `total` number, required
        - `mean` number, nullable, required
        - `max` number, nullable, required
        - `min` number, nullable, required
    - `tags` object, required
      - `other` integer, required: Number of files with tags not listed in `tags`.
      - `tags` object[], required
        - `tag` string, required
        - `count` integer, required
        - `dataSizeBytes` object, required
          - `total` number, required
          - `mean` number, nullable, required
          - `max` number, nullable, required
          - `min` number, nullable, required

## Other responses

- `400`: Returned when `runId` is missing or blank.

---

[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)
