Banyan Technology LIVE Connect™
  1. Updating
Banyan Technology LIVE Connect™
  • Version 3
    • Authentication
      • Retrieve a token
    • Shipments
      • Creating
        • Create a Full Shipment
        • Create an EZ Rate Shipment
      • Updating
        • Add Document(s) to a Shipment
        • Update a Shipment
        • Adds one or more Reference Numbers to a Shipment
        • Mark as Exported
      • Retrieving
        • Get a Shipment
        • Get multiple Shipments
        • Get Quotes
        • Get Reference Numbers for a Shipment
        • Get documents for the specified shipment.
      • Booking
        • Book a Shipment
        • Unbooks the awarded quote on the specified load.
      • Canceling
        • Cancels a shipment.
    • Invoice
      • Get multiple invoices
      • Mark as Exported
    • Tracking
      • Get tracking statuses
      • Mark as exported.
    • StaticData
      • Accessorials
      • Document Types
      • Equipment Types
      • Package Types
      • Limited Access Types
      • Size UOMs
      • Weight UOMs
      • Pay Types
      • Ship Types
      • Countries
      • Statuses
      • Service Modes
  • Version 2
    • Recommended Workflow
      • Rating
        • ImportForQuote
        • ImportForQuote_Sync
        • GetQuotes
      • Booking/Dispatching
        • BookLoad
      • Tracking
        • GetTrackingStatuses
      • Documents
        • GetDocuments
      • Invoices
        • GetInvoices
        • GetInvoicesWithLoadDetails
    • Additional Offerings
      • Cancelling
        • Cancel a Load
      • Updating
        • UpdateLoad
          POST
        • UpdateLoadStatus
          POST
        • UpdateShipmentsExport
          POST
      • Importing
        • PendingImport
        • ImportForBook
      • Manual Quotes
        • AddManualQuote
      • EZ Rates
        • EzRate
        • EzRate_Sync
      • Waterfall Tendering
        • StartWaterfallTendering
        • CancelWaterfallTendering
      • Unbooking
        • UnBookLoad
      • Additional Dispatching
        • DispatchLoad
      • Load Details
        • GetLoadDetails
        • GetNotes
      • Additional Tracking
        • GetTrackingByLoad
      • Other
        • Normalized Charge Codes
      • SOAP
    • Changelog
  • Exports and Webhooks
    • Standard Load Export - v1
    • Standard Load Export - v2
    • Standard Load Export - v3
    • Push Tracking
  1. Updating

UpdateLoadStatus

POST
/services/api/rest/UpdateLoadStatus
This function will change the status of a shipment. This will return the identification number of the shipment that was updated.
This function is not to be used to switch shipments between booked or dispatched back to open or vice versa.
Suggested uses of this function include:
Moving pending shipments to open
Moving shipments from dispatched to in transit
Moving shipments from in transit to delivered
Moving shipments from canceled to open

Request

Header Params
Accept
string 
required
Example:
application/json
Body Params application/json
AuthenticationData
object (Authentication Data) 
required
Banyan Credentials
Username
string 
required
Banyan Username
Password
string 
required
Banyan Password
ClientRefNum
string  | null 
optional
Client Reference Number - Used during multiple client integrations
LoadId
integer 
required
Banyan's primary Shipment Identifier
NewStatus
enum<string> 
required
The new status for the shipment provided
Allowed values:
PendingOpenQuotedBookedDispatchedIn TransitDeliveredCanceled
Example
{
  "AuthenticationData": {
    "Username": "username",
    "Password": "password",
    "ClientRefNum": ""
  },
  "LoadId": 123456,
  "NewStatus": "Dispatched"
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://ws.integration.banyantechnology.com/services/api/rest/UpdateLoadStatus' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
    "AuthenticationData": {
        "Username": "username",
        "Password": "password",
        "ClientRefNum": ""
    },
    "LoadId": 123456,
    "NewStatus": "Dispatched"
}'

Responses

🟢200UpdateLoadStatus - 200 OK
application/json
Body
LoadId
integer 
required
Banyan's primary Shipment Identifier
Success
boolean 
required
Success of the request
Error
optional
Error message supplied when request fails
Any of
Message
string 
required
Example
{
  "LoadId": 52479246,
  "Success": true,
  "Error": {
    "Message": ""
  }
}
Modified at 2024-09-16 11:42:17
Previous
UpdateLoad
Next
UpdateShipmentsExport
Built with