---
title: "Get the most recent usage snapshot (usage data for billing purposes) for a Site."
method: GET
path: "/site/usage"
tags: ["site", "Usage Snapshots"]
---

# Get the most recent usage snapshot (usage data for billing purposes) for a Site.

`GET /site/usage`

Get the most recent usage snapshot (usage data for billing purposes) for a Site.

## Response `200`

The Site object.

- UsageSnapshotEntity — UsageSnapshotEntity model
  - `id` integer — Usage snapshot ID
  - `start_at` string, date-time — Usage snapshot start date/time
  - `end_at` string, date-time — Usage snapshot end date/time
  - `high_water_user_count` integer — Highest user count number in time period
  - `current_storage` integer — Current total Storage Usage GB as of end date (not necessarily high water mark, which is used for billing)
  - `high_water_storage` integer — Highest Storage Usage GB recorded in time period (used for billing)
  - `root_storage` integer — Storage Usage for root folder as of end date (not necessarily high water mark, which is used for billing)
  - `deleted_files_counted_in_minimum` integer — Storage Usage for files that are deleted but uploaded within last 30 days as of end date (not necessarily high water mark, which is used for billing)
  - `deleted_files_storage` integer — Storage Usage for files that are deleted but retained as backups as of end date (not necessarily high water mark, which is used for billing)
  - `total_billable_usage` integer — Storage + Transfer Usage - Total Billable amount
  - `total_billable_transfer_usage` integer — Transfer usage for period - Total Billable amount
  - `bytes_sent` integer — Transfer Usage for period - Outbound GB from Files Native Storage
  - `sync_bytes_received` integer — Transfer Usage for period - Inbound GB to Remote Servers (Sync/Mount)
  - `sync_bytes_sent` integer — Transfer Usage for period - Outbound GB from Remote Servers (Sync/Mount)
  - `usage_by_top_level_dir` UsageByTopLevelDirEntity[] — Storage Usage - map of root folders to their usage as of end date (not necessarily high water mark, which is used for billing)
    - `dir` string — Directory name
    - `size` integer — Usage
    - `count` integer — File count

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `405` — Method Not Allowed
- `409` — Conflict
- `412` — Precondition Failed
- `422` — Unprocessable Entity
- `423` — Locked
- `429` — Too Many Requests

---

[API](https://skmtc.net/files/apis/files-com-api.md) · [All operations](https://skmtc.net/files/apis/files-com-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/files/files-com-api/revisions/c6d6f57e6da8/schema)