Get 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.

GET /v1/billing/usage_summary

cURL

cURL

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

200

{
  "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

Send Authorization: Bearer <api_key>. The legacy Authorization: Api-Key <api_key> scheme is also 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 | null

Dedicated model serving usage

Show child attributes

training_usage · TrainingUsageV1 · object | null

Training usage

Show child attributes

model_apis_usage · ModelApisUsageV1 · object | null

Model APIs usage

Show child attributes