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

# Get RTO state

> Get the shipment RTO process, status, cargo, and account totals.

Get the shipment RTO process status, cargo totals, and account balances.

### Path Parameters

<ParamField path="id" type="string" required>
  Shipment Public ID (`shp_…`).
</ParamField>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "shipmentId": "shp_3f9a1c0e5b7d4e2f8a6c1b9d0e3f7a25",
    "processType": "IMPORT_HANDLING",
    "status": {
      "code": "IN_PROGRESS",
      "message": "The RTO process is in progress.",
      "updatedAt": "2026-06-10T08:30:00.000Z"
    },
    "packageCount": 12,
    "grossWeightKg": 480.5,
    "rtoStartedAt": "2026-06-10T08:30:00.000Z",
    "rtoCompletedAt": null,
    "rtoDurationDays": null,
    "accountTotals": {
      "RTO_IN": { "packages": 12, "weightKg": 480.5 },
      "STOCK": { "packages": 8, "weightKg": 320 },
      "IN_TRANSIT": { "packages": 2, "weightKg": 80 },
      "RTO_OUT": { "packages": 2, "weightKg": 80.5 }
    },
    "stock": {
      "reported": { "packageCount": 10, "grossWeightKg": 400 },
      "remaining": { "packageCount": 2, "grossWeightKg": 80.5 }
    }
  }
  ```
</ResponseExample>