---
title: "Get Data File Storage Usage"
method: GET
path: "/v2/data/usage"
tags: ["data"]
---

# Get Data File Storage Usage

`GET /v2/data/usage`

Return current data-file storage use and the team's effective limits.

## Response `200`

Successful Response

- DataFileStorageUsageResponse — Current storage use and effective limits for the caller's team and folder.
  - `usage` DataFileStorageUsage, required
    - `team` DataFileStorageScopeUsage, required
      - `file_count` integer, required
      - `size_bytes` integer, required
    - `shared` DataFileStorageScopeUsage, required
      - `file_count` integer, required
      - `size_bytes` integer, required
    - `member` DataFileStorageScopeUsage, required
      - `file_count` integer, required
      - `size_bytes` integer, required
  - `limits` union, required
    - BoundedDataFileStorageLimits — Concrete storage capacity for a metered team.
      - `kind` 'bounded', required
      - `max_files_per_member` integer, required
      - `max_member_bytes` integer, required
      - `max_shared_files` integer, required
      - `max_shared_bytes` integer, required
      - `max_team_files` integer, required
      - `max_team_bytes` integer, required
    - UnlimitedDataFileStorageLimits — Unmetered storage capacity for an unlimited team.
      - `kind` 'unlimited', required

## Other responses

- `400` — Invalid or malformed request
- `401` — Missing or invalid credentials
- `403` — Caller may not access this resource
- `404` — Referenced entity does not exist
- `409` — Resource already exists

## Changes

- **2026-09-04** `a01d5d765d1e` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/hud/apis/hud-platform/changes/v2/data/usage/get.md)

---

[API](https://skmtc.dev/hud/apis/hud-platform.md) · [All operations](https://skmtc.dev/hud/apis/hud-platform/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hud/hud-platform/revisions/a01d5d765d1e/schema)