Banyan Technology LIVE Connect™
  1. Tracking
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
          POST
      • Documents
        • GetDocuments
      • Invoices
        • GetInvoices
        • GetInvoicesWithLoadDetails
    • Additional Offerings
      • Cancelling
        • Cancel a Load
      • Updating
        • UpdateLoad
        • UpdateLoadStatus
        • UpdateShipmentsExport
      • 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. Tracking

GetTrackingStatuses

POST
/services/api/rest/GetTrackingStatuses
This function will return all the tracking statuses for all the clients under your web service user’s super user group. Tracking statuses can either be gathered by Banyan’s automated tracking process or EDI 214 process.
Each status will only be exported once. The carrier message returned in the response is directly from the carrier and is simply parsed by Banyan. Banyan does not make any adjustments to that message

Request

Header Params
Content-Type
string 
required
Example:
application/json
Accept
string 
optional
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
Example
{
  "Username": "",
  "Password": "",
  "ClientRefNum": ""
}

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/GetTrackingStatuses' \
--header 'Content-Type: application/json' \
--data-raw '{
    "Username": "",
    "Password": "",
    "ClientRefNum": ""
}'

Responses

🟢200GetTrackingStatuses
application/json
Body
TrackingStatuses
array [object {9}] 
optional
A list of tracking statuses
LoadId
integer 
required
Banyan's primary Shipment Identifier
BOL
string 
required
Shipment's BOL number
ProNumber
string 
optional
Shipment's pro number
DateTime
string <date-time>
optional
The tracking status's date and time (carrier supplied)
Code
string 
required
The tracking status's EDI 214 code
CarrierMessage
string 
optional
The tracking status's message (carrier supplied)
BanyanMessage
string 
required
The tracking status's EDI 214 message.
City
string 
optional
The tracking status's current city (carrier supplied)
State
string 
optional
The tracking status's current state (carrier supplied)
Success
boolean 
required
Success of the cancel request
Error
string  | null 
optional
Error message supplied when request fails
Example
{
  "TrackingStatuses": [
    {
      "LoadID": 12345678,
      "BOL": "3000555567",
      "ProNumber": "207000555",
      "DateTime": null,
      "Code": "T1",
      "CarrierMessage": "En route to interim Bismarck, ND ",
      "BanyanMessage": "In Transit",
      "City": "Bismarck",
      "State": "ND"
    },
    {
      "LoadID": 87654321,
      "BOL": "3000123456",
      "ProNumber": "207555000",
      "DateTime": null,
      "Code": "T2",
      "CarrierMessage": "En route to destination Lumberton, NC ",
      "BanyanMessage": "En Route to Delivery Location",
      "City": "Lumberton",
      "State": "NC"
    }
  ],
  "Success": true,
  "Error": null
}
Previous
BookLoad
Next
GetDocuments
Built with