---
title: "Catalog-tracked vs. actual GCS storage size for a DuckLake integration"
method: GET
path: "/v4/admin/lake/storage/{integration_id}"
tags: ["v4", "Admin"]
---

# Catalog-tracked vs. actual GCS storage size for a DuckLake integration

`GET /v4/admin/lake/storage/{integration_id}`

## Path parameters

- `integration_id` union, required
  - string, uuid
  - string

## Response `200`

Success

- SuccessResponseDuckLakeStorageSizeResponse
  - `success` true, required — Flag for it request was successful
  - `data` DuckLakeStorageSizeResponse, required
    - `integrationId` union, required — DuckLake integration these sizes belong to
      - string, uuid
      - string
    - `catalogSizeBytes` integer — Live catalog-tracked storage in bytes (current snapshot data files)
    - `gcsSizeBytes` integer, nullable — Actual on-storage usage in bytes under the team's GCS bucket prefix (tracked + orphaned), or null when the scan could not be completed (transient GCS error or missing per-team prefix)
  - `meta` ResponseMeta
    - `requestId` string — Unique request identifier for tracing
    - `timestamp` string, date-time — Response timestamp (UTC)
    - `durationMs` integer, nullable — Request processing time in milliseconds

## Other responses

- `401` — Auth Invalid Token
- `403` — Forbidden Insufficient Permissions
- `404` — Resource Not Found
- `422` — Validation Failed
- `426` — Business Quota Exceeded
- `500` — Internal Error

---

[API](https://skmtc.dev/definite/apis/defapi.md) · [All operations](https://skmtc.dev/definite/apis/defapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/definite/defapi/revisions/5ea378187147/schema)