Get billing usage summary

GET

billing

usage_summary

cURL

curl --request GET \
--url https://api.baseten.co/v1/billing/usage_summary \
--header "Authorization: Bearer $BASETEN_API_KEY"

{
  "dedicated_usage": {
    "subtotal": 123,
    "credits_used": 123,
    "total": 123,
    "minutes": 123,
    "breakdown": [
      {
        "billable_resource": {
          "id": "<string>",
          "is_deleted": true,
          "name": "<string>",
          "model_name": "<string>",
          "instance_type": "<string>",
          "environment_name": "<string>",
          "chain_metadata": {
            "chain_id": "<string>",
            "chain_deployment_id": "<string>",
            "chain_name": "<string>"
          }
        },
        "subtotal": 123,
        "minutes": 123,
        "inference_requests": 123,
        "daily": [
          {
            "date": "2023-12-25",
            "subtotal": 123,
            "minutes": 123,
            "inference_requests": 123
          }
        ]
      }
    ]
  },
  "training_usage": {
    "subtotal": 123,
    "credits_used": 123,
    "total": 123,
    "minutes": 123,
    "breakdown": [
      {
        "billable_resource": {
          "id": "<string>",
          "is_deleted": true,
          "name": "<string>",
          "model_name": "<string>",
          "instance_type": "<string>",
          "environment_name": "<string>",
          "chain_metadata": {
            "chain_id": "<string>",
            "chain_deployment_id": "<string>",
            "chain_name": "<string>"
          }
        },
        "subtotal": 123,
        "minutes": 123,
        "daily": [
          {
            "date": "2023-12-25",
            "subtotal": 123,
            "minutes": 123
          }
        ]
      }
    ]
  },
  "model_apis_usage": {
    "subtotal": 123,
    "credits_used": 123,
    "total": 123,
    "breakdown": [
      {
        "model_name": "<string>",
        "subtotal": 123,
        "input_tokens": 123,
        "output_tokens": 123,
        "cached_input_tokens": 123,
        "model_family": "<string>",
        "daily": [
          {
            "date": "2023-12-25",
            "subtotal": 123,
            "input_tokens": 123,
            "output_tokens": 123,
            "cached_input_tokens": 123
          }
        ]
      }
    ]
  }
}

Authorizations

Authorization

string

header

required

Pass your Baseten API key. Clients automatically send Authorization: Bearer <key>. Direct callers can also use Authorization: Api-Key <key>; both schemes are accepted.

Query Parameters

start_date

string<date-time>

required

Start date (ISO 8601, UTC). Earliest queryable: 2026-01-01.

end_date

string<date-time>

required

End date in ISO 8601 format (UTC). Date range cannot exceed 31 days.

Response

200 - application/json

Billing usage summary for the requested date range.

dedicated_usage

DedicatedUsageV1 · object

Dedicated model serving usage

Show child attributes

training_usage

TrainingUsageV1 · object

Training usage

Show child attributes

model_apis_usage

ModelApisUsageV1 · object

Model APIs usage

Show child attributes

OverviewProgrammatically manage Baseten Training resources.

⌘I

cURL

curl --request GET \
--url https://api.baseten.co/v1/billing/usage_summary \
--header "Authorization: Bearer $BASETEN_API_KEY"

{
  "dedicated_usage": {
    "subtotal": 123,
    "credits_used": 123,
    "total": 123,
    "minutes": 123,
    "breakdown": [
      {
        "billable_resource": {
          "id": "<string>",
          "is_deleted": true,
          "name": "<string>",
          "model_name": "<string>",
          "instance_type": "<string>",
          "environment_name": "<string>",
          "chain_metadata": {
            "chain_id": "<string>",
            "chain_deployment_id": "<string>",
            "chain_name": "<string>"
          }
        },
        "subtotal": 123,
        "minutes": 123,
        "inference_requests": 123,
        "daily": [
          {
            "date": "2023-12-25",
            "subtotal": 123,
            "minutes": 123,
            "inference_requests": 123
          }
        ]
      }
    ]
  },
  "training_usage": {
    "subtotal": 123,
    "credits_used": 123,
    "total": 123,
    "minutes": 123,
    "breakdown": [
      {
        "billable_resource": {
          "id": "<string>",
          "is_deleted": true,
          "name": "<string>",
          "model_name": "<string>",
          "instance_type": "<string>",
          "environment_name": "<string>",
          "chain_metadata": {
            "chain_id": "<string>",
            "chain_deployment_id": "<string>",
            "chain_name": "<string>"
          }
        },
        "subtotal": 123,
        "minutes": 123,
        "daily": [
          {
            "date": "2023-12-25",
            "subtotal": 123,
            "minutes": 123
          }
        ]
      }
    ]
  },
  "model_apis_usage": {
    "subtotal": 123,
    "credits_used": 123,
    "total": 123,
    "breakdown": [
      {
        "model_name": "<string>",
        "subtotal": 123,
        "input_tokens": 123,
        "output_tokens": 123,
        "cached_input_tokens": 123,
        "model_family": "<string>",
        "daily": [
          {
            "date": "2023-12-25",
            "subtotal": 123,
            "input_tokens": 123,
            "output_tokens": 123,
            "cached_input_tokens": 123
          }
        ]
      }
    ]
  }
}