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
        GET
      • Mark as exported.
        POST
    • 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
        • 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

Get tracking statuses

GET
/api/v3/tracking
Tracking
Returns a list of all shipments that match the provided criteria and their tracking updates.
Tracking statuses are not marked as exported by default, please use the Mark as exported endpoint to mark tracking statuses as exported.
Web Tracking codes
enum<string> 
Web Tracking codes
optional
Allowed values:
A3A7A9AAABADTAFAGAHAIAJAMANAOTAPAPAAPEAPTAAPTCAPTMARATDAVAWB6BABCBCFBILLBOKBPBRCC1CACALLCDCDISCDLCDSCECCFSCLCLOCLSCPCPATCPDCRLCUSTCD1D1SSDCCDELIVEREDDFDMRDSVDVNEADEDSENRENRTEPXERTETPFBOGNOGTOHDHLDHOHPI1INTLIPITITPJ1K1L1LBLDDLDGLoadedOAOFDOFLOHDOHFONHOOOTBOWTP1PAPPCFPicked UpPRPRAPRRPRTRR1RLRPES1SASDSISLVSPOTSPUSSSUBTendered ICMXTendered MXEXTPTSUAULULCUNLUnloadedVAPVITRCWCWDX1X2X3X4X5X6X8X9XB
EDI Tracking Codes
enum<string> 
EDI Tracking Codes
optional
Allowed values:
A3A7A9AAABADAFAGAHAIAJAMANAPARAVAWB5B6BABCC1CACDCLCPD1HCHDHLI1J1K1L1LBLDOAOOP1PRR1RLS1SDWEX1X2X3X4X5X6X8X9XB

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Query Params
LatestStatusOnly
boolean 
optional
True if only the most recent tracking status should be returned.
Ids
array[string]
required
The ids of objects that should be updated.

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 GET 'https://ws.integration.banyantechnology.com/api/v3/tracking?Ids'

Responses

🟢200Success
application/json
Body
array of:
shipmentId
integer <int32>
optional
The Banyan shipment (load) id.
bol
string  | null 
optional
The BOL Number for the shipment.
proNumber
string  | null 
optional
The ProNumber for the shipment.
trackingStatuses
array[object (TrackingStatusDto) {14}]  | null 
optional
Any tracking statuses that belong to the shipment.
trackingStatusId
integer <int32>
optional
The id of the tracking entity. This can relate to either web or edi statuses, refer to BanyanWebServices.Domain.Dtos.Tracking.TrackingStatusDto.Type to determine which.
dateTime
string <date-time>
optional
The date and time that the tracking event occurred. If this was not provided by the carrier, it will be the time Banyan received the event. See .
timeZoneInfo
object (TimeZoneDto) 
optional
Time zone information
type
string  | null 
optional
The type of tracking status. Web or EDI.
code
string 
optional
The tracking code.
carrierMessage
string  | null 
optional
The actual carrier message for this tracking event.
banyanMessage
string  | null 
optional
The Banyan message for this tracking event.
city
string  | null 
optional
The city the event occurred in.
state
string  | null 
optional
The state the event occurred in.
countryCode
string  | null 
optional
The country the event occurred in.
zipCode
string  | null 
optional
The zip code the event occurred in.
latitude
number <double> | null 
optional
The latitude the event occurred at.
longitude
number <double> | null 
optional
The longitude the event occurred at.
dateTimeType
string  | null 
optional
If an actual date and time were provided from the carrier, this will be Carrier. Otherwise Banyan.
Example
[
  {
    "shipmentId": 0,
    "bol": "string",
    "proNumber": "string",
    "trackingStatuses": [
      {
        "trackingStatusId": 0,
        "dateTime": "2019-08-24T14:15:22Z",
        "timeZoneInfo": {
          "abbreviation": "string",
          "fullName": "string",
          "utcOffset": 0
        },
        "type": "string",
        "code": "string",
        "carrierMessage": "string",
        "banyanMessage": "string",
        "city": "string",
        "state": "string",
        "countryCode": "string",
        "zipCode": "string",
        "latitude": 0,
        "longitude": 0,
        "dateTimeType": "string"
      }
    ]
  }
]
🟠400Bad Request
🟠401Unauthorized
🟠403Forbidden
🟠404Not Found
🟠429Too Many Requests
Modified at 2024-09-16 11:42:17
Previous
Mark as Exported
Next
Mark as exported.
Built with