> ## Documentation Index
> Fetch the complete documentation index at: https://docs.paxos.com/llms.txt
> Use this file to discover all available pages before exploring further.

# orchestration_status_details_change

> Event object returned for orchestration.status_details.* events

This object is returned by the [Get Event API](/api-reference/endpoints/events/get-event) for any `orchestration.status_details.*` event. The shape matches what `GET /orchestration/orchestrations/{id}` returns directly.

## Object Fields

<ResponseField name="id" type="string" required>
  The Paxos orchestration ID.
</ResponseField>

<ResponseField name="ref_id" type="string" required>
  The client-specified ID of the orchestration for replay protection and lookup.
</ResponseField>

<ResponseField name="status" type="string" required>
  Top-level status of the orchestration at the time this event fired.

  **Available options:** `PENDING`, `PROCESSING`, `FAILED`, `REJECTED`
</ResponseField>

<ResponseField name="orchestration_rule_id" type="string">
  The ID of the orchestration rule that triggered this orchestration. Omitted for ad-hoc orchestrations.
</ResponseField>

<ResponseField name="status_details" type="object" required>
  Exactly one slug key is present, matching the event type suffix. Each slug's value carries a `message` string, an optional `awaiting_action_from` enum, and optional per-type fields.

  **`awaiting_action_from` values:**

  * `AWAITING_ACTION_FROM_CLIENT` — customer or admin action is required before processing resumes.
  * `AWAITING_ACTION_FROM_PAXOS` — Paxos is processing; no customer action is needed.
  * Omitted on terminal sub-states (`conversion_failed`, `destination_transfer_failed`, `policy_rejected`).
</ResponseField>

<ResponseExample>
  ```json pending_customer_approval theme={null}
  {
    "id": "ee1a802f-7557-4c59-b833-9a1ef29630d5",
    "ref_id": "my-orchestration-001",
    "status": "PENDING",
    "status_details": {
      "pending_customer_approval": {
        "message": "This orchestration requires approval before it can be processed.",
        "awaiting_action_from": "AWAITING_ACTION_FROM_CLIENT"
      }
    }
  }
  ```

  ```json conversion_in_progress theme={null}
  {
    "id": "ee1a802f-7557-4c59-b833-9a1ef29630d5",
    "orchestration_rule_id": "86d3929f-0090-45e5-8195-dbcf63c43eec",
    "ref_id": "auto_rule_generated_ref_123",
    "status": "PROCESSING",
    "status_details": {
      "conversion_in_progress": {
        "message": "The source asset is being converted.",
        "awaiting_action_from": "AWAITING_ACTION_FROM_PAXOS"
      }
    }
  }
  ```

  ```json destination_transfer_in_progress theme={null}
  {
    "id": "ee1a802f-7557-4c59-b833-9a1ef29630d5",
    "ref_id": "my-orchestration-001",
    "status": "PROCESSING",
    "status_details": {
      "destination_transfer_in_progress": {
        "message": "The destination transfer is pending settlement.",
        "awaiting_action_from": "AWAITING_ACTION_FROM_PAXOS"
      }
    }
  }
  ```

  ```json destination_transfer_failed theme={null}
  {
    "id": "ee1a802f-7557-4c59-b833-9a1ef29630d5",
    "ref_id": "my-orchestration-001",
    "status": "FAILED",
    "status_details": {
      "destination_transfer_failed": {
        "message": "The destination transfer could not be completed.",
        "transfer_id": "{transfer_id}",
        "ref_path": "/v2/transfer/transfers/{transfer_id}"
      }
    }
  }
  ```

  ```json policy_rejected theme={null}
  {
    "id": "ee1a802f-7557-4c59-b833-9a1ef29630d5",
    "ref_id": "my-orchestration-001",
    "status": "REJECTED",
    "status_details": {
      "policy_rejected": {
        "message": "The orchestration was rejected by a policy rule."
      }
    }
  }
  ```

  ```json conversion_failed theme={null}
  {
    "id": "ee1a802f-7557-4c59-b833-9a1ef29630d5",
    "ref_id": "my-orchestration-001",
    "status": "FAILED",
    "status_details": {
      "conversion_failed": {
        "message": "The source asset conversion could not be completed."
      }
    }
  }
  ```
</ResponseExample>