---
title: "Get database usage and billing"
method: GET
path: "/database/v1/usage"
tags: ["Database"]
---

# Get database usage and billing

`GET /database/v1/usage`

Returns detailed database usage statistics and billing information for the current billing period. Includes compute hours, storage, data transfer, and branch counts with associated costs broken down by project.

## Response `200`

Database usage statistics and billing information

- object
  - `period` object
    - `start` string, date-time — Start of the billing period
    - `end` string, date-time — End of the billing period
  - `pricing` object — Current pricing rates
    - `computePerCuHour` number — Cost per compute unit hour in dollars
    - `storagePerGbMonth` number — Cost per GB of storage per month in dollars
    - `transferPerGb` number — Cost per GB of data transfer in dollars
    - `branchPerMonth` number — Cost per branch per month in dollars
    - `freeBranches` integer — Number of free branches included
  - `totals` object — Aggregated totals across all projects
    - `computeCuHours` number — Total compute unit hours
    - `storageGbMonths` number — Total storage in GB-months
    - `transferGb` number — Total data transfer in GB
    - `totalBranches` integer — Total number of branches
    - `computeCostDollars` string — Total compute cost formatted as dollars
    - `storageCostDollars` string — Total storage cost formatted as dollars
    - `transferCostDollars` string — Total transfer cost formatted as dollars
    - `branchCostDollars` string — Total branch cost formatted as dollars
    - `totalCostDollars` string — Total cost formatted as dollars
  - `projects` object[] — Usage breakdown by project
    - `id` string
    - `projectId` string
    - `projectName` string, nullable
    - `computeCuHours` number
    - `storageGbMonths` number
    - `transferGb` number
    - `branchCount` integer
    - `costs` object
      - `compute` string
      - `storage` string
      - `transfer` string
      - `branches` string
      - `total` string
    - `lastUpdated` string, date-time
  - `projectCount` integer — Total number of projects with usage

## Other responses

- `401` — Authentication required
- `403` — Access denied - database or compute permission required

---

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