GEgetaxonflow
Multi-Agent Planning

Get plan execution status

Retrieve the status of a plan by ID.

Returns detailed execution status including:

  • Overall plan status (pending, executing, completed, failed, expired)
  • Step-level progress with completion percentage
  • Duration and cost tracking
  • Error details if execution failed

New in #1075: Response now includes unified execution tracking with:

  • steps array with individual step status
  • progress_percent for real-time progress
  • duration for elapsed time
  • estimated_cost_usd and actual_cost_usd for cost tracking
get/api/v1/plan/{id}

Request

Path parameters

idstring required

Plan ID (e.g., plan_1705312200_abc123)

Response

Plan status retrieved successfully

plan_idstring required

Original plan identifier

execution_idstring

Unified execution ID for cross-system tracking

status'pending' | 'executing' | 'completed' | 'failed' | 'expired' | 'cancelled' | 'aborted' | 'awaiting_approval' required

Current execution status

querystring required

Original user query that created the plan

domainstring required

Domain classification of the plan

total_stepsinteger required

Total number of steps in the plan

completed_stepsinteger

Number of completed steps

progress_percentnumber float

Completion percentage (0-100)

durationstring

Human-readable elapsed duration

estimated_cost_usdnumber float

Estimated total cost in USD

actual_cost_usdnumber float

Actual cost incurred so far in USD

created_atstring date-time

When the plan was created

started_atstring date-time

When execution started

completed_atstring date-time

When execution completed (if terminal)

expires_atstring date-time

When the plan expires

errorstring

Error message if status is failed

metadataobject

Additional plan metadata

Example response

{
  "plan_id": "plan_1705312200_abc123",
  "execution_id": "plan_xyz789",
  "status": "executing",
  "query": "Research competitor pricing strategies",
  "domain": "finance",
  "total_steps": 3,
  "completed_steps": 1,
  "progress_percent": 33.33,
  "duration": "15s",
  "estimated_cost_usd": 0.05,
  "actual_cost_usd": 0.042,
  "steps": [
    {
      "step_id": "step_0_analyze",
      "step_name": "analyze",
      "step_type": "llm_call",
      "status": "completed",
      "duration": "8s",
      "model": "gpt-4",
      "provider": "openai",
      "cost_usd": 0.04
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.