---
title: "List"
method: GET
path: "/shipping_integrations/ontime360/orders/list/v1"
tags: ["/shipping_integrations"]
---

# List

`GET /shipping_integrations/ontime360/orders/list/v1`

Lists mirrored OnTime360 orders for the caller's organization with filtering, sorting, pagination, and optional search. | () -> (OnTime360OrderListRes)

## Query parameters

- `sort_by` 'mirrored_at_timestamp' | 'created_at_timestamp' | 'updated_at_timestamp' | 'integration_order_id'
- `sort_order` 'asc' | 'desc' — Sort order for query results
- `page` integer
- `page_size` integer
- `search` string, nullable — Search OnTime360 order IDs.
- `filter_provider_org_id` string[], nullable — Filter by provider org ID(s)
- `filter_integration_order_id` string, nullable — Filter by OnTime360's exact order GUID
- `filter_provider_status_level` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 — Operational status of an order. The live OpenAPI spec declares `StatusLevel` and `Status.Level` as enum name strings while the wire format is the integer ordinal, so the validator below accepts either. Ordinals are the vendor's own and are what we store.
- `filter_mirrored_at_timestamp_gte` string, date-time, nullable — Filter mirrored_at_timestamp >= value
- `filter_mirrored_at_timestamp_lte` string, date-time, nullable — Filter mirrored_at_timestamp <= value
- `filter_created_at_timestamp_gte` string, date-time, nullable — Filter created_at_timestamp >= value
- `filter_created_at_timestamp_lte` string, date-time, nullable — Filter created_at_timestamp <= value
- `filter_updated_at_timestamp_gte` string, date-time, nullable — Filter updated_at_timestamp >= value
- `filter_updated_at_timestamp_lte` string, date-time, nullable — Filter updated_at_timestamp <= value

## Response `200`

Successful Response

- OnTime360OrderListRes
  - `items` OnTime360Order1[], required
    - `schema_version` 1, required
    - `_id` string, required
    - `org_id` string, required — Must be a string starting with `org_`
    - `shipping_integration` 'ontime360', required
    - `provider_org_id` string, required — Must be a string starting with `org_`
    - `integration_order_id` string, required
    - `provider_payload` OnTime360OrderResponse1, required — Known fields from an OnTime360 order, retaining all other fields.
      - `ID` string, required
      - `TrackingNumber` string, nullable
      - `ReferenceNumber` string, nullable
      - `PurchaseOrderNumber` string, nullable
      - `IncomingTrackingNumber` string, nullable
      - `OutgoingTrackingNumber` string, nullable
      - `RequestedBy` string, nullable
      - `Description` string, nullable
      - `Comments` string, nullable
      - `RouteName` string, nullable
      - `SubmissionSource` string, nullable
      - `Status` OnTime360StatusResponse1
        - `ID` string, nullable
        - `Name` string, nullable
        - `Description` string, nullable
        - `Timestamp` string, nullable
        - `Level` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 — Operational status of an order. The live OpenAPI spec declares `StatusLevel` and `Status.Level` as enum name strings while the wire format is the integer ordinal, so the validator below accepts either. Ordinals are the vendor's own and are what we store.
      - `StatusLevel` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 — Operational status of an order. The live OpenAPI spec declares `StatusLevel` and `Status.Level` as enum name strings while the wire format is the integer ordinal, so the validator below accepts either. Ordinals are the vendor's own and are what we store.
      - `Customer` string, nullable
      - `Dispatcher` string, nullable
      - `DriverCurrentlyAssigned` string, nullable
      - `CollectionAssignedDriver` string, nullable
      - `DeliveryAssignedDriver` string, nullable
      - `CollectionLocation` OnTime360LocationResponse1
        - `ID` string, nullable
        - `Zone` OnTime360ZoneResponse1
          - `ID` string, nullable
          - `Name` string, nullable
        - `ContactName` string, nullable
        - `CompanyName` string, nullable
        - `AddressLine1` string, nullable
        - `AddressLine2` string, nullable
        - `City` string, nullable
        - `State` string, nullable
        - `PostalCode` string, nullable
        - `Country` string, nullable
        - `LatitudeLongitude` string, nullable
      - `DeliveryLocation` OnTime360LocationResponse1
        - `ID` string, nullable
        - `Zone` OnTime360ZoneResponse1
          - `ID` string, nullable
          - `Name` string, nullable
        - `ContactName` string, nullable
        - `CompanyName` string, nullable
        - `AddressLine1` string, nullable
        - `AddressLine2` string, nullable
        - `City` string, nullable
        - `State` string, nullable
        - `PostalCode` string, nullable
        - `Country` string, nullable
        - `LatitudeLongitude` string, nullable
      - `Distance` number, nullable
      - `DateSubmitted` string, nullable
      - `CollectionArrivalWindow` OnTime360TimeWindowResponse1
        - `EarliestTime` string, nullable
        - `LatestTime` string, nullable
        - `Length` string, nullable
      - `DeliveryArrivalWindow` OnTime360TimeWindowResponse1
        - `EarliestTime` string, nullable
        - `LatestTime` string, nullable
        - `Length` string, nullable
      - `CollectionArrivalDate` string, nullable
      - `DeliveryArrivalDate` string, nullable
      - `CollectionContactName` string, nullable
      - `DeliveryContactName` string, nullable
      - `CollectionSignatureRequired` boolean, nullable
      - `DeliverySignatureRequired` boolean, nullable
      - `Items` OnTime360ItemResponse1[], nullable
        - `ID` string, nullable
        - `OrderID` string, nullable
        - `TrackingNumber` string, nullable
        - `Description` string, nullable
        - `Weight` number, nullable
      - `Weight` number, nullable
      - `Height` number, nullable
      - `Width` number, nullable
      - `Length` number, nullable
      - `Quantity` integer, nullable
      - `DeclaredValue` number, nullable
      - `BasePrice` number, nullable
      - `PriceAdjustment` number, nullable
      - `PriceModifiers` OnTime360PriceModifierResponse1[], nullable
        - `ID` string, nullable
        - `Name` string, nullable
        - `InternalName` string, nullable
        - `Price` number, nullable
      - `PriceModifierTotalCost` number, nullable
      - `TaxTotal` number, nullable
      - `Subtotal` number, nullable
      - `TotalCost` number, nullable
      - `CODAmount` number, nullable
      - `DriverCoordinatesOnCollection` string, nullable
      - `DriverCoordinatesOnDelivery` string, nullable
    - `provider_payload_hash` string, required
    - `created_at_timestamp` string, date-time, required
    - `updated_at_timestamp` string, date-time, required
    - `mirrored_at_timestamp` string, date-time, required
  - `total_count` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/chrt/apis/chrt-fastapi.md) · [All operations](https://skmtc.dev/chrt/apis/chrt-fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/chrt/chrt-fastapi/revisions/ea04e157edb3/schema)