> ## 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 Status

> Get the status and progress of a compute goal

## Overview

Check where a compute goal stands: status, current phase, plan, budget, and timing.

## Path Parameters

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

## Response

<ResponseField name="data.id" type="string">Goal ID</ResponseField>
<ResponseField name="data.status" type="string">Goal status: `active`, `completed`, `cancelled`, `failed`</ResponseField>
<ResponseField name="data.name" type="string">Short name for the goal</ResponseField>
<ResponseField name="data.objective" type="string">Full objective text</ResponseField>
<ResponseField name="data.current_phase" type="integer">Current execution phase</ResponseField>
<ResponseField name="data.plan" type="object">Orchestrator's execution plan</ResponseField>

<ResponseField name="data.budget" type="object">
  Budget summary with `total`, `spent`, `reserved`, `remaining` (all in USDC)
</ResponseField>

<ResponseField name="data.soul_agent_id" type="string">Associated soul agent ID (if any)</ResponseField>
<ResponseField name="data.started_at" type="string">When execution began</ResponseField>
<ResponseField name="data.completed_at" type="string">When the goal completed (if finished)</ResponseField>
<ResponseField name="data.last_wake_at" type="string">Last time the orchestrator woke for this goal</ResponseField>
<ResponseField name="data.next_wake_at" type="string">Scheduled next wake (if waiting)</ResponseField>
<ResponseField name="data.wake_version" type="integer">Wake version counter. Increments each time the orchestrator schedules a new wake, used to discard stale scheduled wakes.</ResponseField>

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

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "data": {
      "id": "goal_01HX8K3YZ...",
      "status": "active",
      "name": "Research AI frameworks and build comparison page",
      "objective": "Research the top 10 AI agent frameworks...",
      "current_phase": 2,
      "plan": {
        "phases": [
          { "name": "Research", "tasks": 3 },
          { "name": "Build", "tasks": 2 },
          { "name": "Deliver", "tasks": 1 }
        ]
      },
      "budget": {
        "total": "8.500000",
        "spent": "2.150000",
        "reserved": "3.000000",
        "remaining": "3.350000"
      },
      "started_at": "2026-01-15T12:00:00Z",
      "last_wake_at": "2026-01-15T12:05:30Z",
      "created_at": "2026-01-15T12:00:00Z"
    }
  }
  ```
</ResponseExample>