Skip to main content
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 milliseconds
object
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

X-API-Key
string
header
required

API key for machine-to-machine authentication

Path Parameters

orchestrationId
string<uuid>
required

Orchestration identifier

Response

Orchestration details

orchestration_id
string<uuid>
workflow_id
string<uuid>
agents
string<uuid>[]
parameters
object
status
enum<string>
Available options:
pending,
running,
completed,
failed,
cancelled
steps
object[]
results
object
receipts
string<uuid>[]
created_at
string<date-time>