> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oneshotagent.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Goal Budget

> Get the budget status and spend history for a compute goal

## Overview

Shows the budget ledger for a compute goal: how much was deposited, spent, reserved, and what's left. Includes a line-by-line spend history.

## Path Parameters

<ParamField path="goalId" type="string" required>
  The goal ID returned from the create endpoint
</ParamField>

## Response

<ResponseField name="data.totalBudgetUsdc" type="string">Total budget deposited</ResponseField>
<ResponseField name="data.spentUsdc" type="string">Amount spent so far</ResponseField>
<ResponseField name="data.reservedUsdc" type="string">Amount reserved for in-flight tasks</ResponseField>
<ResponseField name="data.remainingUsdc" type="string">Available remaining budget</ResponseField>

<ResponseField name="data.spend_entries" type="array">
  Individual spend entries:

  * `category` — Spend category (e.g., `research`, `browser`, `build`, `orchestrator`)
  * `amount_usdc` — Amount spent
  * `description` — What the spend was for
  * `created_at` — When the spend was recorded
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl https://win.oneshotagent.com/v1/compute/goal_01HX8K3YZ/budget \
    -H "Content-Type: application/json"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "data": {
      "totalBudgetUsdc": "8.500000",
      "spentUsdc": "2.150000",
      "reservedUsdc": "3.000000",
      "remainingUsdc": "3.350000",
      "spend_entries": [
        {
          "category": "research",
          "amount_usdc": "0.850000",
          "description": "Deep research: AI agent frameworks",
          "created_at": "2026-01-15T12:04:50Z"
        },
        {
          "category": "orchestrator",
          "amount_usdc": "0.300000",
          "description": "Orchestrator wake: planning phase 2",
          "created_at": "2026-01-15T12:04:55Z"
        },
        {
          "category": "sandbox",
          "amount_usdc": "1.000000",
          "description": "Sandbox compute: 0.4 hours",
          "created_at": "2026-01-15T12:04:50Z"
        }
      ]
    }
  }
  ```
</ResponseExample>