WarpBuild LogoWarpBuild Docs
Reports

GET /reports/billing/agents

Returns billing data for Claude managed-agent agent VMs: a daily cost chart, summary totals, a paginated per-instance entry list, and available filters (labels, environments).

GET
/reports/billing/agents

Authorization

JWTKeyAuth
Authorization<token>

In: header

Query Parameters

start_date*string

Start date (RFC3339)

end_date*string

End date (RFC3339)

sort_by?string

Sort column: timestamp, label, environment_id, exec_duration_seconds, cost (default: timestamp)

sort_order?string

Sort direction: asc or desc (default: desc)

labels?array<string>

Filter by runner labels

environment_ids?array<string>

Filter by Claude environment ids

search?string

Search by agent VM, label, environment, session

page?integer

Page number (default: 1)

per_page?integer

Items per page (default: 50, max: 200)

format?string

Response format: json or csv (default: json)

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/reports/billing/agents?start_date=string&end_date=string"
{  "available_filters": {    "environment_ids": [      "string"    ],    "labels": [      "string"    ]  },  "chart": {    "bucket_interval_seconds": 0,    "daily": [      {        "date": "string",        "segments": [          {            "cost": 0,            "job_count": 0,            "key": "string"          }        ],        "total_cost": 0      }    ],    "group_by": "string"  },  "entries": {    "items": [      {        "cost": 0,        "environment_id": "string",        "exec_duration_seconds": 0,        "label": "string",        "runner_instance_id": "string",        "session_id": "string",        "timestamp": "string"      }    ],    "next": 0,    "page": 0,    "per_page": 0,    "total_pages": 0,    "total_rows": 0  },  "organization_id": "string",  "summary": {    "total_cost": 0,    "total_entries": 0  }}

POST /reports/exports

Queues a background job that generates the report CSV, uploads it to storage, and emails the requester when the download is ready. Params mirror the query parameters of the corresponding sync report endpoint.

GET /reports/billing/cache

Returns billing data for cache operations including chart data, summary, paginated entry list, and available filters.