---
title: "Get Billing Usage"
method: GET
path: "/billing/usage/{metric}"
tags: ["integrations"]
---

# Get Billing Usage

`GET /billing/usage/{metric}`

## Path parameters

- `metric` 'traces' | 'spans' | 'luna_tokens' | 'luna_fine_tuning_runs', required

## Query parameters

- `start_time` string, date-time, required — Start of time range (UTC)
- `end_time` string, date-time, required — End of time range (UTC)
- `interval` 'hourly' | 'daily' | 'weekly' | 'monthly', required
- `project_id` string, uuid, nullable — Optional project filter

## Response `200`

Successful Response

- BillingUsageResponse
  - `metric` 'traces' | 'spans' | 'luna_tokens' | 'luna_fine_tuning_runs', required
  - `total` integer
  - `projects` ProjectBillingUsage[]
    - `project_id` string, uuid4, required
    - `project_name` string, required
    - `total` integer
    - `data_points` BillingUsageDataPoint[]
      - `timestamp` string, date-time, required
      - `value` integer, required
  - `available` boolean
  - `unavailable_reason` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/galileo/apis/galileo-api-server.md) · [All operations](https://skmtc.net/galileo/apis/galileo-api-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/galileo/galileo-api-server/versions/933e8c8e6366/schema)