Get Orchestration
Orchestrations & Workflows
Get Orchestration
Retrieve the full execution result of an orchestration, including step-level details and cost tracking.
GET
Get Orchestration
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
string
required
API key with
orchestrations:read scope. Alternatively, pass a Bearer JWT
token in the Authorization header.string
required
Tenant identifier for multi-tenant isolation.
Path Parameters
string
required
Orchestration identifier (
maip-orch:ULID).Response
string
Orchestration identifier.
string
The agent that executed the orchestration.
string
The workflow definition identifier, if applicable.
string
Current status:
running, completed, failed, or timeout.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 millisecondsobject
Final orchestration output. Present only when status is
completed.number
Total accumulated cost of all LLM inferences and tool calls in US cents.
string
Transparency-log receipt anchoring the completed orchestration. Present only
when status is
completed.string
ISO 8601 timestamp when execution began.
string
ISO 8601 timestamp when execution finished. Present only for terminal states.
object
Error details if status is
failed. Contains code and message.Authorizations
API key for machine-to-machine authentication
Path Parameters
Orchestration identifier

