---
updatedAt: 2026-08-05T00:00:57.000Z
agentTools:
  projectIndex: https://developer.drivewealth.com/apis/llms.txt
---

# Retrieve Autopilot Run

Retrieves an Autopilot Run by rebalanceRunID.

<br />

# OpenAPI definition

```json
{
  "openapi": "3.0.2",
  "info": {
    "title": "Advisor APIs",
    "version": "2026-10-08",
    "contact": {
      "email": "producteng@drivewealth.tech"
    }
  },
  "servers": [
    {
      "url": "https://bo-api.drivewealth.io/back-office",
      "description": "Sandbox (No Real World Financial/Trading Impact)"
    },
    {
      "url": "https://bo-api.drivewealth.net/back-office",
      "description": "Production"
    }
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "x-readme": {
    "explorer-enabled": false,
    "headers": [
      {
        "key": "dw-client-app-key",
        "value": "{{yourAppKey}}"
      }
    ]
  },
  "tags": [
    {
      "name": "AutoPilot"
    }
  ],
  "paths": {
    "/managed/autopilot/{rebalanceRunID}": {
      "get": {
        "tags": [
          "AutoPilot"
        ],
        "parameters": [
          {
            "in": "path",
            "name": "rebalanceRunID",
            "schema": {
              "type": "string"
            },
            "required": true,
            "example": "ria_rebalance_123e4567-e89b-12d3-a456-00000000000c",
            "description": "The unique re-balance run identifier `rebalanceRunID` associated with a specific re-balance."
          }
        ],
        "summary": "Retrieve Autopilot Run",
        "description": "Retrieves an Autopilot Run by rebalanceRunID.",
        "responses": {
          "200": {
            "description": "Retrieving an Autopilot Run by rebalanceRunID was Successful.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runStatusRes"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "runStatusRes": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "example": "ria_rebalance_123e4567-e89b-12d3-a456-000000000012",
            "description": "The unique re-balance run identifier `rebalanceRunID` associated with a specific re-balance."
          },
          "riaID": {
            "type": "string",
            "example": "123e4567-e89b-12d3-a456-000000000167",
            "description": "This is the parentIBID or userID of the registered investment advisor creating the re-balance run."
          },
          "status": {
            "type": "string",
            "example": "REBALANCE_NOT_STARTED",
            "description": "Status of the re-balance run. See [Autopilot Run Status](https://developer.drivewealth.com/reference/get-autopilot-run-status) for status values."
          },
          "updated": {
            "type": "string",
            "example": "2022-12-27T06:07:28.955Z",
            "description": "A timestamp of when the re-balance run was updated."
          },
          "created": {
            "type": "string",
            "example": "2022-12-27T06:06:28.955Z",
            "description": "A timestamp of when the re-balance run was created."
          },
          "moneyMovement": {
            "type": "boolean",
            "example": true,
            "description": "Was this run part of the regular AutoPilot money movement process?"
          },
          "regularRebalance": {
            "type": "boolean",
            "example": true,
            "description": "Was this run part of the regular AutoPilot rebalancing process?"
          },
          "reviewOnly": {
            "type": "boolean",
            "example": true
          },
          "orders": {
            "type": "object",
            "description": "An object containing the details of submitted orders for the re-balance.",
            "properties": {
              "total": {
                "type": "number",
                "example": 0,
                "description": "Total number of orders submitted."
              },
              "submitted": {
                "type": "string",
                "example": "https://example-bucket.s3.amazonaws.com/44304da9....",
                "description": "Amazon S3 download containing the details of each submitted order."
              },
              "outcome": {
                "type": "string",
                "example": "https://example-bucket.s3....",
                "description": "Amazon S3 download containing the status and final outcome of the orders that were submitted."
              },
              "amountBuys": {
                "type": "number",
                "example": -1059.35,
                "description": "An aggregate value of all buy orders. Expect a negative number."
              },
              "amountSells": {
                "type": "number",
                "example": 862.69,
                "description": "An aggregate value of all sell orders."
              },
              "cleanedUp": {
                "type": "string",
                "example": null
              }
            }
          },
          "allocations": {
            "type": "object",
            "description": "An object containing the details of the allocations in a re-balance.",
            "properties": {
              "submitted": {
                "type": "string",
                "example": "https://example-bucket.s3....",
                "description": "Amazon S3 download containing the details of each submitted allocation."
              },
              "outcome": {
                "type": "string",
                "example": "https://example-bucket.s3....",
                "description": "Amazon S3 download containing the status and final outcome of each allocation that was submitted."
              }
            }
          },
          "subAccounts": {
            "type": "object",
            "description": "An object containing details on user accounts and their holdings.",
            "properties": {
              "total": {
                "type": "number",
                "example": 4,
                "description": "The total number of user accounts under the advisor."
              },
              "rebalanced": {
                "type": "number",
                "example": 3,
                "description": "The total number of user accounts that were rebalanced."
              },
              "error": {
                "type": "number",
                "example": 0,
                "description": "The total number of allocation errors at the users account level during the rebalance."
              },
              "outcome": {
                "type": "string",
                "example": "https://example-bucket.s3....",
                "description": "Amazon S3 download containing the final outcome of the rebalance, includes users account details and their holdings."
              }
            }
          }
        }
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT"
      }
    }
  }
}
```

# Sibling pages

* [Create Autopilot Run](https://developer.drivewealth.com/apis/reference/post_managed-autopilot-partnerid.md)
* [Retrieve Portfolio by Account](https://developer.drivewealth.com/apis/reference/get_accounts-accountid-portfolio.md)
* [List AutoPilot Runs by Advisor](https://developer.drivewealth.com/apis/reference/get_users-userid-managed-autopilot.md)