Skip to main content

Quotes and orders

Create and update quotes, approve them into orders, work with order stops, holds and invoices created from orders, and read order history.

Paths are relative to https://api.rushhourapp.com/api/v1. See the API reference overview for how to read each entry.

Quotes and order stops​

MethodPathSummary
GET/QuotesSearches for quotes based on provided criteria.
POST/QuotesCreates a new quote.
DELETE/QuotesDeletes multiple quotes in a single request.
GET/Quotes/{id}Retrieves detailed information for a specific quote.
DELETE/Quotes/{id}Deletes a specific quote.
PUT/Quotes/{id}/{quoteUpdateType}Updates an existing quote with new details.
PUT/Quotes/{id}/{quoteUpdateType}/editUpdate a quote or order. The record and the kind of update are read from the request body.
PUT/Quotes/{id}/BuyingPriceUpdate buying price.
GET/Quotes/{id}/copyOrderToDriverRetrieves an order prepared for copying to a driver.
GET/Quotes/{id}/Items/{itemId}/EventsRetrieves the shipment timeline of a single item on an order/quote.
PUT/Quotes/{id}/MoveOrderStopOnRouteToUnassignedMoves an assigned order stop back to the unassigned pool.
PUT/Quotes/{id}/repeatCreates a new order by repeating an existing quote.
GET/Quotes/{id}/RoutesRetrieves all routes associated with a specific order.
PUT/Quotes/{id}/SwapSwaps pickup and delivery stops for a specific order or quote.
GET/Quotes/{id}/TripsRetrieves trip information for a specific quote.
PUT/Quotes/{id}/UndoOrderUndoes an entire order by reverting all active order stops.
POST/Quotes/{orderId}/OrderStopAdds a new stop (pickup, delivery, or transfer) to an existing order.
PUT/Quotes/{orderStopId}/appointmentStatus/{status}Updates the appointment status for a specific order stop.
PUT/Quotes/{orderStopId}/callOutcome/{callOutcome}Updates the call outcome for a specific order stop.
PUT/Quotes/{orderStopId}/driverInstructionsUpdates the driver instructions for a specific order stop.
PUT/Quotes/{orderStopId}/priority/{priority}Updates the priority of a specific order stop.
PUT/Quotes/{orderStopId}/UndoOrderStopUndoes a single order stop assignment.
GET/Quotes/{orderStopId}/UndoOrderStopsInfoRetrieves information needed to undo an order stop assignment.
PUT/Quotes/ApproveQuoteApproves a quote and converts it into an order.
PUT/Quotes/ApproveQuotesBulkApproves multiple quotes in bulk and converts them into orders.
POST/Quotes/AssignHubAssigns the two hubs a pickup/delivery pair has been waiting on.
GET/Quotes/exportExports one or more quotes to an Excel file.
POST/Quotes/ImportOrderStopsImports order stops (pickups and deliveries) from a CSV file.
GET/Quotes/ImportOrderStopsExampleProvides a sample CSV file for importing order stops.
GET/Quotes/QuoteCheck/{orderNumber}Validates whether a quote or order number already exists.
GET/Quotes/RecentUsedAddressesRetrieves the most recently used addresses for a specific customer.
GET/Quotes/RecentUsedCustomerContactRetrieves the most recently used customer contact for a given customer.
PUT/Quotes/UndoOrderStopsUndoes one or more order stop assignments.
POST/Quotes/ValidateQuoteWarehousesValidates the pickup and delivery warehouses for a quote.

GET /Quotes​

Searches for quotes based on provided criteria.

Also accepts the shared list parameters.

Response: envelope; data is OrderPagedList.

POST /Quotes​

Creates a new quote.

Request body: Order (JSON).

Response: envelope; data is Order.

DELETE /Quotes​

Deletes multiple quotes in a single request.

Request body: array of integer (int32) (JSON).

Response: envelope; data has no documented shape.

GET /Quotes/{id}​

Retrieves detailed information for a specific quote.

Parameters

NameInTypeRequiredDescription
idpathinteger (int32)YesUnique identifier of the quote (order ID).
moveCompletedToTheEndquerybooleanNoIf true, completed items are moved to the end of the response. Default: false.

Also accepts the shared list parameters.

Response: envelope; data is OrderDto.

DELETE /Quotes/{id}​

Deletes a specific quote.

Parameters

NameInTypeRequiredDescription
idpathinteger (int32)YesUnique identifier of the quote (order ID) to delete.

Response: envelope; data has no documented shape.

PUT /Quotes/{id}/{quoteUpdateType}​

Updates an existing quote with new details.

Parameters

NameInTypeRequiredDescription
idpathinteger (int32)YesUnique identifier of the quote/order being updated.
quoteUpdateTypepathinteger (int32)YesOne of: 0 (PickupDraft), 1 (PickupDone), 2 (DeliveryDraft), 3 (DeliveryDone), 4 (Pricing), 5 (Recurrence), 6 (OrderRouteBehavior).
completeQuoteRouteItemsquerybooleanNoFlag indicating whether to complete route items as part of the update. Default: false.
createCustomerFromQuotequerybooleanNoFlag indicating whether to create a customer record from the quote when transitioning to an order. Default: false.
createInvoicequerybooleanNoFlag indicating whether to create an invoice as part of the update. Default: true.
returnQuotequerybooleanNoIndicates whether the updated quote should be returned in the response. Default: true.

Request body: Order (JSON).

Response: envelope; data is Order.

PUT /Quotes/{id}/{quoteUpdateType}/edit​

Update a quote or order. The record and the kind of update are read from the request body.

The id and quoteUpdateType values in the path are not used. The API updates the order given by orderId in the body, using the quoteUpdateType from the body, so make sure the body carries the values you mean.

Parameters

NameInTypeRequiredDescription
idpathstringYesNot used. The order is taken from orderId in the request body.
quoteUpdateTypepathstringYesNot used. The kind of update is taken from quoteUpdateType in the request body.

Request body: UpdateQuoteDto (JSON).

Response: envelope; data is Order.

PUT /Quotes/{id}/BuyingPrice​

Update buying price.

Required access: the Company Admin role.

Parameters

NameInTypeRequiredDescription
idpathinteger (int32)Yes

Request body: UpdateBuyingPriceDto (JSON).

Response: envelope; data has no documented shape.

GET /Quotes/{id}/copyOrderToDriver​

Retrieves an order prepared for copying to a driver.

Required access: the Copy Order for Driver permission.

Parameters

NameInTypeRequiredDescription
idpathinteger (int32)YesUnique identifier of the order to prepare for driver copy.
orderStopIdqueryinteger (int32)NoOptional order stop ID. If provided, filters to only the specified stop.
routeIdqueryinteger (int32)NoOptional route ID. If provided, filters stops and route items to only those belonging to the specified route.

Response: envelope; data is OrderDto.

GET /Quotes/{id}/Items/{itemId}/Events​

Retrieves the shipment timeline of a single item on an order/quote.

Parameters

NameInTypeRequiredDescription
idpathinteger (int32)YesUnique identifier of the order/quote the item belongs to.
itemIdpathinteger (int32)YesUnique identifier of the order item whose timeline is being retrieved.

Response: envelope; data is array of OrderItemEventDto.

PUT /Quotes/{id}/MoveOrderStopOnRouteToUnassigned​

Moves an assigned order stop back to the unassigned pool.

Required access: the Assign/Unassign Order permission.

Parameters

NameInTypeRequiredDescription
idpathinteger (int32)YesUnique identifier of the order stop to be moved to unassigned.

Request body: AttemptRequest (JSON).

Response: envelope; data has no documented shape.

PUT /Quotes/{id}/repeat​

Creates a new order by repeating an existing quote.

Required access: the Repeat Order permission.

Parameters

NameInTypeRequiredDescription
idpathinteger (int32)YesUnique identifier of the quote to be repeated.

Response: envelope; data is OrderDto.

GET /Quotes/{id}/Routes​

Retrieves all routes associated with a specific order.

Parameters

NameInTypeRequiredDescription
idpathinteger (int32)YesUnique identifier of the order whose routes are being retrieved.
includeInactiveRoutesquerybooleanNoFlag indicating whether inactive routes should be included in the response. Default: true.

Response: envelope; data is RoutePagedList.

PUT /Quotes/{id}/Swap​

Swaps pickup and delivery stops for a specific order or quote.

Parameters

NameInTypeRequiredDescription
idpathinteger (int32)YesUnique identifier of the order or quote whose stops are being swapped.

Response: envelope; data has no documented shape.

GET /Quotes/{id}/Trips​

Retrieves trip information for a specific quote.

Parameters

NameInTypeRequiredDescription
idpathinteger (int32)YesUnique identifier of the quote whose trips are being retrieved.

Response: envelope; data is array of OrderTrip.

PUT /Quotes/{id}/UndoOrder​

Undoes an entire order by reverting all active order stops.

Required access: the Undo Order permission.

Parameters

NameInTypeRequiredDescription
idpathinteger (int32)YesUnique identifier of the order to be undone.

Response: envelope; data has no documented shape.

POST /Quotes/{orderId}/OrderStop​

Adds a new stop (pickup, delivery, or transfer) to an existing order.

Parameters

NameInTypeRequiredDescription
orderIdpathinteger (int32)YesUnique identifier of the order to which the stop will be added.

Request body: OrderStop (JSON).

Response: envelope; data is OrderStop.

PUT /Quotes/{orderStopId}/appointmentStatus/{status}​

Updates the appointment status for a specific order stop.

Parameters

NameInTypeRequiredDescription
orderStopIdpathinteger (int32)YesUnique identifier of the order stop whose appointment status is being updated.
statuspathstringYesThe new appointment status to assign to the order stop. One of: Nothing, Request, Requested, Approve, Accepted, Review, NewAppointment.
appointmentCodequerystringNoOptional confirmation code.
appointmentEmailquerystringNo
sendRequestquerybooleanNoOpt in to sending the appointment request email. Default: false.

Response: envelope; data is OrderStop.

PUT /Quotes/{orderStopId}/callOutcome/{callOutcome}​

Updates the call outcome for a specific order stop.

Parameters

NameInTypeRequiredDescription
callOutcomepathinteger (int32)YesThe new call outcome value to assign to the order stop. One of: 1 (CallNotMade), 2 (Possible), 3 (NotPossible).
orderStopIdpathinteger (int32)YesUnique identifier of the order stop whose call outcome is being updated.

Response: envelope; data is OrderStop.

PUT /Quotes/{orderStopId}/driverInstructions​

Updates the driver instructions for a specific order stop.

Required access: the Edit Orders permission.

Parameters

NameInTypeRequiredDescription
orderStopIdpathinteger (int32)YesUnique identifier of the order stop whose driver instructions are being updated.

Request body: OrderStopDriverInstructionsDto (JSON).

Response: envelope; data has no documented shape.

PUT /Quotes/{orderStopId}/priority/{priority}​

Updates the priority of a specific order stop.

Required access: the Update stop priority permission.

Parameters

NameInTypeRequiredDescription
orderStopIdpathinteger (int32)YesUnique identifier of the order stop whose priority is being updated.
prioritypathstringYesThe new priority value to assign to the order stop. One of: Low, Regular, High.

Response: envelope; data has no documented shape.

PUT /Quotes/{orderStopId}/UndoOrderStop​

Undoes a single order stop assignment.

Required access: the Undo Order permission.

Parameters

NameInTypeRequiredDescription
orderStopIdpathinteger (int32)YesUnique identifier of the order stop to be undone.

Response: envelope; data has no documented shape.

GET /Quotes/{orderStopId}/UndoOrderStopsInfo​

Retrieves information needed to undo an order stop assignment.

Required access: the Undo Order permission.

Parameters

NameInTypeRequiredDescription
orderStopIdpathinteger (int32)YesUnique identifier of the order stop for which undo information is requested.

Response: envelope; data is array of OrderStop.

PUT /Quotes/ApproveQuote​

Approves a quote and converts it into an order.

Required access: the Approve Quote permission.

Parameters

NameInTypeRequiredDescription
quoteIdqueryinteger (int32)NoUnique identifier of the quote to be approved.

Response: envelope; data has no documented shape.

PUT /Quotes/ApproveQuotesBulk​

Approves multiple quotes in bulk and converts them into orders.

Required access: the Approve Quote permission.

Request body: array of integer (int32) (JSON).

Response: envelope; data has no documented shape.

POST /Quotes/AssignHub​

Assigns the two hubs a pickup/delivery pair has been waiting on.

Request body: AssignHubRequest (JSON).

Response: envelope; data has no documented shape.

GET /Quotes/export​

Exports one or more quotes to an Excel file.

Parameters

NameInTypeRequiredDescription
idsqueryarray of integer (int32)NoList of quote IDs (order IDs) to export.
samplequerybooleanNoIf true, generates a sample Excel file instead of actual quote data.

Response: a file download, not JSON.

POST /Quotes/ImportOrderStops​

Imports order stops (pickups and deliveries) from a CSV file.

Required access: the Edit Orders permission.

Parameters

NameInTypeRequiredDescription
orderIdqueryinteger (int32)NoOptional existing order ID. If provided, stops are imported into this order. Default: 0.

Request body: form data (multipart/form-data).

FieldType
csvFilefile
orderJsonstring

Response: envelope; data has no documented shape.

GET /Quotes/ImportOrderStopsExample​

Provides a sample CSV file for importing order stops.

Response: a file download, not JSON.

GET /Quotes/QuoteCheck/{orderNumber}​

Validates whether a quote or order number already exists.

Parameters

NameInTypeRequiredDescription
orderNumberpathstringYesThe order number to validate against existing orders.

Response: envelope; data has no documented shape.

GET /Quotes/RecentUsedAddresses​

Retrieves the most recently used addresses for a specific customer.

Parameters

NameInTypeRequiredDescription
countqueryinteger (int32)NoMaximum number of addresses to return. Default: 10.
customerIdqueryinteger (int32)NoUnique identifier of the customer whose recent addresses are being retrieved.

Response: envelope; data is array of Address.

GET /Quotes/RecentUsedCustomerContact​

Retrieves the most recently used customer contact for a given customer.

Parameters

NameInTypeRequiredDescription
customerIdqueryinteger (int32)NoUnique identifier of the customer whose recent contact is being retrieved.

Response: envelope; data is integer (int32).

PUT /Quotes/UndoOrderStops​

Undoes one or more order stop assignments.

Required access: the Undo Order permission.

Request body: array of integer (int32) (JSON).

Response: envelope; data has no documented shape.

POST /Quotes/ValidateQuoteWarehouses​

Validates the pickup and delivery warehouses for a quote.

Request body: QuoteWarehousesRequest (JSON).

Response: envelope; data has no documented shape.

Orders​

MethodPathSummary
GET/OrdersSearches for orders based on the provided criteria.
GET/Orders/{id}/ActivitiesRetrieves all stop activities for a specific order.
PUT/Orders/{id}/Activities/{activityId}/NoteAdds or updates a note on a specific activity log event.
DELETE/Orders/{id}/Activities/{activityId}/NoteDeletes a note from a specific activity log event.
GET/Orders/{id}/ActivityLogRetrieves the activity log for a specific order.
GET/Orders/{id}/AuditLogGet order audit log.
GET/Orders/{id}/BarcodesGet order barcodes.
PUT/Orders/{id}/closeCloses an existing order.
PUT/Orders/{id}/close-and-create-invoiceCloses an order and creates a new invoice.
GET/Orders/{id}/contactsRetrieves the list of customer contact details associated with a specific order.
POST/Orders/{id}/HoldPlaces a hold on an entire order (covers every delivery / drop-off stop).
GET/Orders/{id}/HoldsLists the holds on an order (active + resolved history).
PUT/Orders/{id}/invoiceCreates or replaces an invoice associated with a specific order.
DELETE/Orders/{id}/invoiceDeletes the invoice(s) associated with a specific order.
GET/Orders/{id}/JobSiteEmailsRetrieves job site email addresses associated with a specific order.
GET/Orders/{id}/OrderStopsWarningsRetrieves warnings and validation issues for order stops.
DELETE/Orders/{id}/PermanentPermanently deletes an existing order and all related data.
PUT/Orders/{id}/priority/{priority}Updates the priority of an existing order.
PUT/Orders/{id}/RestoreRestores a previously deleted order.
PUT/Orders/{id}/revertRevert order to quote.
GET/Orders/{id}/RouteCardsRetrieves route card details for a specific order.
GET/Orders/{id}/SentEmailsRetrieves sent emails associated with a specific order.
GET/Orders/{id}/StopsGet active order stops.
POST/Orders/{id}/Stops/{orderStopId}/HoldPlaces a hold on a single delivery (drop-off) stop of an order.
PUT/Orders/{id}/Stops/{orderStopId}/WaitingTimeRecords waiting time (arrival, departure, waiting and free time) for one stop of the order.
GET/Orders/{id}/StopsInfoRetrieves detailed stop and item information for an order.
GET/Orders/{id}/tripsRetrieves the calculated trips associated with a specific order.
PUT/Orders/{id}/UpdateOrderStopsDateAndTimeUpdates the date and time information for one or more order stops.
GET/Orders/AddressSearches and returns a list of addresses based on filters and search criteria.
POST/Orders/CalculatePriceCalculates pricing information for a given order.
POST/Orders/Holds/{holdId}/ResolveResolves (removes) a hold manually ("mark resolved").
GET/Orders/MapViewGet orders with the locations needed to show them on a map.
GET/Orders/OrderListBasicDetailsRetrieves a paginated list of orders with basic details.
GET/Orders/OrderQuoteListRetrieves a paginated list of orders and quotes based on search criteria.
GET/Orders/StatsGet order statistics.

GET /Orders​

Searches for orders based on the provided criteria.

Also accepts the shared list parameters.

Response: envelope; data is OrderPagedList.

GET /Orders/{id}/Activities​

Retrieves all stop activities for a specific order.

Parameters

NameInTypeRequiredDescription
idpathinteger (int32)YesUnique identifier of the order whose stop activities are being retrieved.
orderStopIdqueryinteger (int32)NoOptional identifier of a specific order stop.

Response: envelope; data is array of OrderStopActivityDto.

PUT /Orders/{id}/Activities/{activityId}/Note​

Adds or updates a note on a specific activity log event.

Required access: the Edit Orders permission.

Parameters

NameInTypeRequiredDescription
activityIdpathinteger (int32)YesUnique identifier of the activity event to add the note to.
idpathinteger (int32)YesUnique identifier of the order.

Request body: ActivityNoteDto (JSON).

Response: envelope; data is OrderStopActivityDto.

DELETE /Orders/{id}/Activities/{activityId}/Note​

Deletes a note from a specific activity log event.

Required access: the Edit Orders permission.

Parameters

NameInTypeRequiredDescription
activityIdpathinteger (int32)YesUnique identifier of the activity event whose note should be deleted.
idpathinteger (int32)YesUnique identifier of the order.

Response: envelope; data has no documented shape.

GET /Orders/{id}/ActivityLog​

Retrieves the activity log for a specific order.

Parameters

NameInTypeRequiredDescription
idpathinteger (int32)YesUnique identifier of the order whose activity log is being retrieved.

Response: envelope; data is array of OrderStopActivityDto.

GET /Orders/{id}/AuditLog​

Get order audit log.

Parameters

NameInTypeRequiredDescription
idpathinteger (int32)YesUnique identifier of the order or quote.
ActorTypequerystringNoOne of: Staff, Driver, CustomerPortal, ExternalAnonymous, AiAgent, System.
CategoryquerystringNoOne of: Lifecycle, Details, Stops, Items, Pricing, Charges, Dispatch, Accounting, Other.
FromUtcquerystring (date-time)No
Pagequeryinteger (int32)No
PageSizequeryinteger (int32)No
SearchquerystringNo
ToUtcquerystring (date-time)No

Response: envelope; data is OrderAuditLogDto.

GET /Orders/{id}/Barcodes​

Get order barcodes.

Parameters

NameInTypeRequiredDescription
idpathinteger (int32)Yes

Response: envelope; data is array of OrderBarcodeStopDto.

PUT /Orders/{id}/close​

Closes an existing order.

Required access: the Close and Create Invoice permission.

Parameters

NameInTypeRequiredDescription
idpathinteger (int32)YesUnique identifier of the order to be closed.

Response: envelope; data is Invoice.

PUT /Orders/{id}/close-and-create-invoice​

Closes an order and creates a new invoice.

Required access: the Close and Create Invoice permission.

Parameters

NameInTypeRequiredDescription
idpathinteger (int32)YesUnique identifier of the order to be closed and invoiced.

Request body: ReplaceOrCreateNewInvoiceRequest (JSON).

Response: envelope; data has no documented shape.

GET /Orders/{id}/contacts​

Retrieves the list of customer contact details associated with a specific order.

Required access: the Send and download BOL permission.

Parameters

NameInTypeRequiredDescription
idpathinteger (int32)YesUnique identifier of the order whose customer contacts are being retrieved.
requestCustomerIdqueryinteger (int32)NoOptional customer ID. If provided, retrieves contacts for this customer in addition to the order’s primary customer.

Response: envelope; data is array of CustomerContactDetailsResponse.

POST /Orders/{id}/Hold​

Places a hold on an entire order (covers every delivery / drop-off stop).

Required access: the Place hold on order/delivery permission.

Parameters

NameInTypeRequiredDescription
idpathinteger (int32)Yes

Request body: PlaceHoldDto (JSON).

Response: envelope; data is OrderHoldDto.

GET /Orders/{id}/Holds​

Lists the holds on an order (active + resolved history).

Parameters

NameInTypeRequiredDescription
idpathinteger (int32)Yes
activeOnlyquerybooleanNoDefault: false.

Response: envelope; data is array of OrderHoldDto.

PUT /Orders/{id}/invoice​

Creates or replaces an invoice associated with a specific order.

Parameters

NameInTypeRequiredDescription
idpathinteger (int32)YesUnique identifier of the order for which the invoice is being created.

Request body: ReplaceOrCreateNewInvoiceRequest (JSON).

Response: envelope; data is Invoice.

DELETE /Orders/{id}/invoice​

Deletes the invoice(s) associated with a specific order.

Parameters

NameInTypeRequiredDescription
idpathinteger (int32)YesUnique identifier of the order whose associated invoice(s) should be deleted.

Response: envelope; data has no documented shape.

GET /Orders/{id}/JobSiteEmails​

Retrieves job site email addresses associated with a specific order.

Parameters

NameInTypeRequiredDescription
idpathinteger (int32)YesUnique identifier of the order whose job site emails are being retrieved.
requestCustomerIdqueryinteger (int32)NoOptional customer ID. If provided, filters job site emails to those associated with this customer.

Response: envelope; data is array of JobSiteEmailDto.

GET /Orders/{id}/OrderStopsWarnings​

Retrieves warnings and validation issues for order stops.

Parameters

NameInTypeRequiredDescription
idpathinteger (int32)YesUnique identifier of the order whose stop warnings are being retrieved.

Response: envelope; data is array of OrderStopWarningDto.

DELETE /Orders/{id}/Permanent​

Permanently deletes an existing order and all related data.

Required access: the Company Admin role.

Parameters

NameInTypeRequiredDescription
idpathinteger (int32)YesUnique identifier of the order to be permanently deleted.

Response: envelope; data has no documented shape.

PUT /Orders/{id}/priority/{priority}​

Updates the priority of an existing order.

Parameters

NameInTypeRequiredDescription
idpathinteger (int32)YesUnique identifier of the order.
prioritypathstringYesNew priority value to assign to the order. One of: Low, Regular, High.

Response: envelope; data is Order.

PUT /Orders/{id}/Restore​

Restores a previously deleted order.

Parameters

NameInTypeRequiredDescription
idpathinteger (int32)YesUnique identifier of the order to restore.

Response: envelope; data has no documented shape.

PUT /Orders/{id}/revert​

Revert order to quote.

Required access: the Revert to Quote permission.

Parameters

NameInTypeRequiredDescription
idpathinteger (int32)YesUnique identifier of the order to revert.

Response: envelope; data is Order.

GET /Orders/{id}/RouteCards​

Retrieves route card details for a specific order.

Parameters

NameInTypeRequiredDescription
idpathinteger (int32)YesUnique identifier of the order whose route cards are being retrieved.

Response: envelope; data is RouteCardListDto.

GET /Orders/{id}/SentEmails​

Retrieves sent emails associated with a specific order.

Required access: the Send and download BOL permission.

Parameters

NameInTypeRequiredDescription
idpathinteger (int32)YesUnique identifier of the order whose sent emails are being retrieved.
requestCustomerIdqueryinteger (int32)NoOptional filter.
suggestCustomerPastSentEmailsquerybooleanNoOptional flag. Default: false.

Response: envelope; data is array of SentEmail.

GET /Orders/{id}/Stops​

Get active order stops.

Parameters

NameInTypeRequiredDescription
idpathinteger (int32)YesOrder identifier.

Response: envelope; data is array of OrderStop.

POST /Orders/{id}/Stops/{orderStopId}/Hold​

Places a hold on a single delivery (drop-off) stop of an order.

Required access: the Place hold on order/delivery permission.

Parameters

NameInTypeRequiredDescription
idpathinteger (int32)Yes
orderStopIdpathinteger (int32)Yes

Request body: PlaceHoldDto (JSON).

Response: envelope; data is OrderHoldDto.

PUT /Orders/{id}/Stops/{orderStopId}/WaitingTime​

Records waiting time (arrival, departure, waiting and free time) for one stop of the order.

Parameters

NameInTypeRequiredDescription
idpathinteger (int32)YesOrder id.
orderStopIdpathinteger (int32)YesOrder stop id.

Request body: OrderStopWaitingTimeDto (JSON).

Response: envelope; data has no documented shape.

GET /Orders/{id}/StopsInfo​

Retrieves detailed stop and item information for an order.

Parameters

NameInTypeRequiredDescription
idpathinteger (int32)YesUnique identifier of the order.

Response: envelope; data is OrderInfoDto.

GET /Orders/{id}/trips​

Retrieves the calculated trips associated with a specific order.

Parameters

NameInTypeRequiredDescription
idpathinteger (int32)YesUnique identifier of the order whose trips are being retrieved.

Response: envelope; data is array of OrderTrip.

PUT /Orders/{id}/UpdateOrderStopsDateAndTime​

Updates the date and time information for one or more order stops.

Parameters

NameInTypeRequiredDescription
idpathinteger (int32)YesUnique identifier of the order whose stop dates and times are being updated.

Request body: OrderStopDateAndTimeDto (JSON).

Response: envelope; data is OrderDto.

GET /Orders/Address​

Searches and returns a list of addresses based on filters and search criteria.

Parameters

NameInTypeRequiredDescription
DeliveryAddressesquerybooleanNo
PickUpAddressesquerybooleanNo

Also accepts the shared list parameters.

Response: envelope; data is AddressPagedList.

POST /Orders/CalculatePrice​

Calculates pricing information for a given order.

Request body: Order (JSON).

Response: envelope; data is Order.

POST /Orders/Holds/{holdId}/Resolve​

Resolves (removes) a hold manually ("mark resolved").

Required access: the Resolve/remove hold permission.

Parameters

NameInTypeRequiredDescription
holdIdpathinteger (int32)Yes

Request body: ResolveHoldDto (JSON).

Response: envelope; data is OrderHoldDto.

GET /Orders/MapView​

Get orders with the locations needed to show them on a map.

Parameters

NameInTypeRequiredDescription
maxOrdersqueryinteger (int32)NoOptional cap override. Default: 1000.
Sourcesqueryarray of integer (int32)NoOne of: 0 (Default), 1 (Web), 2 (CustomerPortal).

Also accepts the shared list parameters.

Response: envelope; data is OrdersMapViewResDto.

GET /Orders/OrderListBasicDetails​

Retrieves a paginated list of orders with basic details.

Parameters

NameInTypeRequiredDescription
includeInvoiceInfoquerybooleanNoIf true, invoice information is included in the results. Default: false.
includeQuotesquerybooleanNoIf true, quotes are included in the results along with orders. Default: false.
moveCompletedToTheEndquerybooleanNoIf true, completed orders are moved to the end of the result set. Default: false.
Sourcesqueryarray of integer (int32)NoOne of: 0 (Default), 1 (Web), 2 (CustomerPortal).

Also accepts the shared list parameters.

Response: envelope; data is OrderListDtoPagedList.

GET /Orders/OrderQuoteList​

Retrieves a paginated list of orders and quotes based on search criteria.

Also accepts the shared list parameters.

Response: envelope; data is OrderPagedList.

GET /Orders/Stats​

Get order statistics.

Also accepts the shared list parameters.

Response: envelope; data is OrderStats.

Load units​

MethodPathSummary
POST/LoadUnitsAdd load unit.
PUT/LoadUnits/{id}Update load unit.
DELETE/LoadUnits/{id}Delete load unit.
DELETE/LoadUnits/{id}/ContentDelete load unit content.
GET/LoadUnits/{id}/OrderItemStopGet load unit.

POST /LoadUnits​

Add load unit.

Request body: LoadUnit (JSON).

Response: envelope; data is LoadUnit.

PUT /LoadUnits/{id}​

Update load unit.

Parameters

NameInTypeRequiredDescription
idpathinteger (int32)Yes

Request body: LoadUnit (JSON).

Response: envelope; data is LoadUnit.

DELETE /LoadUnits/{id}​

Delete load unit.

Parameters

NameInTypeRequiredDescription
idpathinteger (int32)Yes

Response: envelope; data is LoadUnit.

DELETE /LoadUnits/{id}/Content​

Delete load unit content.

Parameters

NameInTypeRequiredDescription
idpathinteger (int32)Yes

Response: envelope; data is LoadUnitContent.

GET /LoadUnits/{id}/OrderItemStop​

Get load unit.

Parameters

NameInTypeRequiredDescription
idpathinteger (int32)Yes

Response: envelope; data is array of LoadUnit.

Freight payments​

MethodPathSummary
POST/FreightPaymentsAdd freight payment.
PUT/FreightPayments/{id}Update freight payment.
GET/FreightPayments/{id}/OrderGet freight payments.

POST /FreightPayments​

Add freight payment.

Required access: the Company Admin role.

Request body: FreightPayment (JSON).

Response: envelope; data has no documented shape.

PUT /FreightPayments/{id}​

Update freight payment.

Required access: the Company Admin role.

Parameters

NameInTypeRequiredDescription
idpathinteger (int32)Yes

Request body: FreightPayment (JSON).

Response: envelope; data has no documented shape.

GET /FreightPayments/{id}/Order​

Get freight payments.

Required access: the Company Admin role.

Parameters

NameInTypeRequiredDescription
idpathinteger (int32)Yes

Response: envelope; data has no documented shape.

Order tags​

MethodPathSummary
GET/OrderTags/{orderId}Get order tags.
POST/OrderTags/{orderId}/{tagId}Add order tag.
DELETE/OrderTags/{orderId}/{tagId}Delete order tag.

GET /OrderTags/{orderId}​

Get order tags.

Parameters

NameInTypeRequiredDescription
orderIdpathinteger (int32)Yes

Response: envelope; data is array of OrderTag.

POST /OrderTags/{orderId}/{tagId}​

Add order tag.

Parameters

NameInTypeRequiredDescription
orderIdpathinteger (int32)Yes
tagIdpathinteger (int32)Yes

Response: envelope; data is OrderTag.

DELETE /OrderTags/{orderId}/{tagId}​

Delete order tag.

Parameters

NameInTypeRequiredDescription
orderIdpathinteger (int32)Yes
tagIdpathinteger (int32)Yes

Response: envelope; data has no documented shape.

Tags​

MethodPathSummary
GET/TagsGet tags.
POST/TagsAdd tag.
PUT/Tags/{id}Update tag.
DELETE/Tags/{id}Delete tag.

GET /Tags​

Get tags.

Required access: the Company Admin role.

Response: envelope; data is array of Tag.

POST /Tags​

Add tag.

Required access: the Company Admin role.

Request body: Tag (JSON).

Response: envelope; data is Tag.

PUT /Tags/{id}​

Update tag.

Required access: the Company Admin role.

Parameters

NameInTypeRequiredDescription
idpathinteger (int32)Yes

Request body: Tag (JSON).

Response: envelope; data is Tag.

DELETE /Tags/{id}​

Delete tag.

Required access: the Company Admin role.

Parameters

NameInTypeRequiredDescription
idpathinteger (int32)Yes

Response: envelope; data has no documented shape.