Get Orchestration

Retrieve the full execution result of an orchestration, including step-level details and cost tracking.

Returns the complete execution state of an orchestration, including its current status, every step executed, the final output, accumulated cost, and the transparency-log receipt once completed.

Poll this endpoint to track orchestration progress. For real-time updates, configure a webhook for orchestration.completed and orchestration.failed events.

Authentication

X-API-Key · string · required

API key with orchestrations:read scope. Alternatively, pass a Bearer JWT token in the Authorization header.

X-Tenant-ID · string · required

Tenant identifier for multi-tenant isolation.

Path Parameters

id · string · required

Orchestration identifier (maip-orch:ULID).

Response

id · string

Orchestration identifier.

agent_id · string

The agent that executed the orchestration.

workflow_id · string

The workflow definition identifier, if applicable.

status · string

Current status: running, completed, failed, or timeout.

steps · array

Ordered array of execution steps. Each step contains: - step_number (integer) — Sequential step index (1-based) - action (string) — Action performed (e.g. llm_inference, tool_call, decision, guardrail_check) - result (string) — Step outcome summary - duration_ms (integer) — Step execution time in milliseconds

output · object

Final orchestration output. Present only when status is completed.

total_cost_cents · number

Total accumulated cost of all LLM inferences and tool calls in US cents.

receipt_id · string

Transparency-log receipt anchoring the completed orchestration. Present only when status is completed.

started_at · string

ISO 8601 timestamp when execution began.

completed_at · string

ISO 8601 timestamp when execution finished. Present only for terminal states.

error · object

Error details if status is failed. Contains code and message.