Usage

Retrieve usage and cost summaries for the authenticated account.

Last reviewed July 13, 2026

The usage endpoints return account-level storage, compute, and sync row metrics.

Summary


GET /api/v1/usage/summary

Query Parameters

Parameter	Type	Description
`days`	integer	Number of days to include, clamped to `1-365`

Example Response


{
  "data": {
    "periodDays": 30,
    "periodStart": "2026-03-03",
    "periodEnd": "2026-04-02",
    "storage": { "gb": 12.4, "costUsd": 0.74 },
    "compute": { "gb": 84.2, "costUsd": 1.68 },
    "syncRows": { "total": 1250000 },
    "totalCostUsd": 2.42,
    "queries": { "tbProcessed": 0.08, "costUsd": 1.64 },
    "computeSeconds": 420
  }
}

Daily Usage


GET /api/v1/usage/daily

Query Parameters

Parameter	Type	Description
`days`	integer	Number of days to include, clamped to `1-365`

Example Response


{
  "data": [
    {
      "date": "2026-04-01",
      "storageGb": 12.1,
      "storageCostUsd": 0.02,
      "queryTbProcessed": 0.01,
      "queryCostUsd": 0.2,
      "syncRowsTotal": 42000,
      "totalCostUsd": 0.22,
      "modelComputeSeconds": 5,
      "modelComputeCostUsd": 0.01,
      "modelQueryTbProcessed": 0,
      "modelQueryCostUsd": 0
    }
  ]
}

Notes

days defaults to 30
values are returned in camelCase
summary responses include legacy compatibility fields such as queries and computeSeconds