---
title: "Gets billing usage summary for a date range"
method: GET
path: "/v1/billing/usage_summary"
---

# Gets billing usage summary for a date range

`GET /v1/billing/usage_summary`

Returns billing usage data within the specified date range. Includes dedicated model serving, training, and model APIs usage. The date range must not exceed 31 days.

## Query parameters

- `start_date` string, date-time, required
- `end_date` string, date-time, required

## Response `200`

- UsageSummaryV1 — Billing usage summary for the requested date range.
  - `dedicated_usage` DedicatedUsageV1
    - `subtotal` union, required — Subtotal cost in dollars after applying credits used
      - number
      - string
    - `credits_used` union, required — Credits applied in dollars
      - number
      - string
    - `total` union, required — Total cost in dollars
      - number
      - string
    - `minutes` integer, required — Total minutes used
    - `breakdown` DedicatedItemV1[] — Per-deployment usage breakdown
      - `billable_resource` BillableResourceV1, required
        - `id` string, required — Unique identifier of the resource
        - `kind` 'MODEL_DEPLOYMENT' | 'TRAINING_JOB' | 'CHAINLET', required
        - `name` string, nullable — Name of the resource
        - `model_name` string, nullable — Name of the parent resource (e.g., model name for model deployments, training project name for training jobs)
        - `is_deleted` boolean, required — Indicates if the resource has been deleted
        - `instance_type` string, nullable — Instance type used
        - `environment_name` string, nullable — Environment name (e.g., 'production', 'staging')
        - `chain_metadata` ChainMetadataV1
          - `chain_id` string, required — Unique identifier of the chain
          - `chain_name` string, nullable — Name of the chain
          - `chain_deployment_id` string, required — Unique identifier of the chain deployment
      - `subtotal` union, required — Subtotal cost in dollars for this billable resource
        - number
        - string
      - `compute_cost` union, required — Compute cost in dollars for this billable resource
        - number
        - string
      - `surcharge_cost` union, required — Model distribution surcharge in dollars for this billable resource
        - number
        - string
      - `minutes` integer, required — Total minutes used for this billable resource
      - `inference_requests` integer, required — Total inference requests for this billable resource
      - `daily` DailyDedicatedUsageV1[] — Daily usage breakdown
        - `date` string, date, required — Date of the usage
        - `subtotal` union, required — Subtotal cost incurred on this date in dollars
          - number
          - string
        - `compute_cost` union, required — Compute cost incurred on this date in dollars
          - number
          - string
        - `surcharge_cost` union, required — Model distribution surcharge incurred on this date in dollars
          - number
          - string
        - `minutes` integer, required — Minutes used on this date
        - `inference_requests` integer, required — Number of inference requests on this date
  - `training_usage` TrainingUsageV1
    - `subtotal` union, required — Subtotal cost in dollars after applying credits used
      - number
      - string
    - `credits_used` union, required — Credits applied in dollars
      - number
      - string
    - `total` union, required — Total cost in dollars
      - number
      - string
    - `minutes` integer, required — Total minutes used
    - `breakdown` TrainingItemV1[] — Per-job usage breakdown
      - `billable_resource` BillableResourceV1, required
        - `id` string, required — Unique identifier of the resource
        - `kind` 'MODEL_DEPLOYMENT' | 'TRAINING_JOB' | 'CHAINLET', required
        - `name` string, nullable — Name of the resource
        - `model_name` string, nullable — Name of the parent resource (e.g., model name for model deployments, training project name for training jobs)
        - `is_deleted` boolean, required — Indicates if the resource has been deleted
        - `instance_type` string, nullable — Instance type used
        - `environment_name` string, nullable — Environment name (e.g., 'production', 'staging')
        - `chain_metadata` ChainMetadataV1
          - `chain_id` string, required — Unique identifier of the chain
          - `chain_name` string, nullable — Name of the chain
          - `chain_deployment_id` string, required — Unique identifier of the chain deployment
      - `subtotal` union, required — Subtotal cost in dollars for this billable resource
        - number
        - string
      - `minutes` integer, required — Total minutes used for this billable resource
      - `daily` DailyTrainingUsageV1[] — Daily usage breakdown
        - `date` string, date, required — Date of the usage
        - `subtotal` union, required — Subtotal cost incurred on this date in dollars
          - number
          - string
        - `minutes` integer, required — Minutes used on this date
  - `model_apis_usage` ModelApisUsageV1
    - `subtotal` union, required — Subtotal cost in dollars after applying credits used
      - number
      - string
    - `credits_used` union, required — Credits applied in dollars
      - number
      - string
    - `total` union, required — Total cost in dollars
      - number
      - string
    - `breakdown` ModelApiItemV1[] — Per-model usage breakdown
      - `model_name` string, required — Model name
      - `model_family` string, nullable — Model family (e.g., llama, mistral)
      - `subtotal` union, required — Subtotal cost in dollars for this model
        - number
        - string
      - `input_tokens` integer, required — Total input tokens for this model
      - `output_tokens` integer, required — Total output tokens for this model
      - `cached_input_tokens` integer, required — Total cached input tokens for this model
      - `daily` DailyModelApiUsageV1[] — Daily usage breakdown
        - `date` string, date, required — Date of the usage
        - `subtotal` union, required — Subtotal cost incurred on this date in dollars
          - number
          - string
        - `input_tokens` integer, required — Number of input tokens on this date
        - `output_tokens` integer, required — Number of output tokens on this date
        - `cached_input_tokens` integer, required — Number of cached input tokens on this date

---

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