---
title: "Export hosted tenant usage report for a billing period"
method: GET
path: "/tenant/usage-report"
---

# Export hosted tenant usage report for a billing period

`GET /tenant/usage-report`

## Request

- Base URL: `https://api.gravityads.dev` (the document declares no server; this is the origin it was published from)
- URL: `https://api.gravityads.dev/tenant/usage-report`
- Auth: HTTP bearer

## Query parameters

- `start_date` string
- `end_date` string
- `limit` integer

## Response `200`

Tenant usage report

- object
  - `status` 'hosted_usage_report_ready' | 'hosted_usage_report_unconfigured' | 'hosted_usage_report_failed' | 'hosted_usage_report_degraded', required
  - `schema_version` 'gravityads.hosted_usage_report.v1', required
  - `tenant_id` string, required
  - `billing_period` object, required
  - `daily_rollups` object[], required
  - `daily_row_count` integer, required
  - `tool_usage` object[], required
  - `tool_usage_count` integer, required
  - `tool_result_metrics` object
  - `tool_call_guard_metrics` object
  - `platform_quota_metrics` object
  - `totals` object
  - `database_url_configured` boolean, required
  - `hosted_auth_context` object
  - `raw_secrets_returned` false, required

---

[API](https://skmtc.dev/gravityads/apis/gravityads-api.md) · [All operations](https://skmtc.dev/gravityads/apis/gravityads-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gravityads/apis/gravityads-api/revisions/124cd07d534d?raw)