Get batch execution total cost | Runtype Documentation

Returns the total cost across all records, flow steps, agent executions, and nested subagents, decomposed by how much the figure can be trusted.

Authentication

AuthorizationBearer

API key or Clerk session token

Path parameters

idstringRequired

Batch execution ID

Response

Batch cost

batchExecutionIdstring

billedCostThousandthsCentinteger or null

Exact raw Runtype-funded provider and hosted-tool cost before account margin, in thousandths of a cent ($1 = 100,000), or null when historical/unpriced rows make the split unavailable.

billedCostUsddouble or null

Dollar projection of billedCostThousandthsCent (raw Runtype-funded cost before account margin), or null when the exact split is unavailable.

selfReportedCostUsddouble

Portion of totalCostUsd asserted by an externally-run agent pushed to /v1/executions/ingest. Unverified: Runtype neither dispatched nor paid for it. 0 unless external runs were ingested.

totalCostUsddouble

unpricedExecutionsinteger

Count of rows inside totalCostUsd that recorded no cost figure. Their contribution is 0 because the cost is unknown, not because it was free.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

1	{
2	"batchExecutionId": "string",
3	"billedCostThousandthsCent": 1,
4	"billedCostUsd": 1.1,
5	"selfReportedCostUsd": 1.1,
6	"totalCostUsd": 1.1,
7	"unpricedExecutions": 1
8	}