Banyan Technology LIVE Connect™
  1. Load Details
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
        • 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
          POST
        • GetNotes
          POST
      • 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. Load Details

GetNotes

POST
/services/api/rest/GetNotes
Used to retrieve shipment notesUsed for retrieving information on shipments and invoices.

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
Example
{
  "AuthenticationData": {
    "Username": "",
    "Password": "",
    "ClientRefNum": ""
  },
  "LoadId": 36887370
}

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

Responses

🟢200GetNotes
application/json
Body
Notes
array[object (Note) {4}] 
required
Shipment & carrier notes
Text
string 
required
Note text
User
string 
required
Note creator
DateStamp
string 
required
Note date
NoteType
enum<string> 
required
Note Type
Allowed values:
AccountingAdjustmentEmailArchivingQuoteUpdateCarrierAwardedQuoteTechnicalNoteWebTrackingEdiSystemEventInstructionsPublicBookReasonWebDispatchQuoteRequestPrivateContactAccountingTerminalUrlCustomerDockUpdateAddressDeleteQuotePackageRateExceptionBillingReasonAdditionalServiceValidationQuoteQuoteRequestEmail
Errors
array[string]
required
Success
boolean 
required
Whether request was successful
Example
{
  "Notes": [
    {
      "Text": "Auto Book Failure. Email Sent: True",
      "User": "Automation",
      "DateStamp": "2021-10-28T13:43:54",
      "NoteType": 7
    },
    {
      "Text": "Web Dispatch Failed: &nbsp;&nbsp;•Consignee Contact Name Required &nbsp;&nbsp;•Consignee Phone Number Required &nbsp;&nbsp;•Shipper Contact Name Required &nbsp;&nbsp;•Shipper Phone Number Required",
      "User": "Automation",
      "DateStamp": "2021-10-28T13:43:54",
      "NoteType": 14
    },
    {
      "Text": "Dayton Freight Standard: Pickup Request Failed.",
      "User": "Automation",
      "DateStamp": "2021-10-28T13:43:54",
      "NoteType": 7
    },
    {
      "Text": "Web Dispatch Error returned: </br>Friendly Error: Shipper Phone Number Required</br>Error: Shipper Phone Number Required",
      "User": "Automation",
      "DateStamp": "2021-10-28T13:43:54",
      "NoteType": 7
    },
    {
      "Text": "Web Dispatch Error returned: </br>Friendly Error: Consignee Phone Number Required</br>Error: Consignee Phone Number Required",
      "User": "Automation",
      "DateStamp": "2021-10-28T13:43:54",
      "NoteType": 7
    },
    {
      "Text": "Web Dispatch Error returned: </br>Friendly Error: Shipper Contact Name Required</br>Error: Shipper Contact Name Required",
      "User": "Automation",
      "DateStamp": "2021-10-28T13:43:54",
      "NoteType": 7
    },
    {
      "Text": "Web Dispatch Error returned: </br>Friendly Error: Consignee Contact Name Required</br>Error: Consignee Contact Name Required",
      "User": "Automation",
      "DateStamp": "2021-10-28T13:43:54",
      "NoteType": 7
    },
    {
      "Text": "Overrides: - Billing",
      "User": "Automation",
      "DateStamp": "2021-10-28T13:43:11",
      "NoteType": 7
    },
    {
      "Text": "LoadID:36887370 BolNum: QuoteID:330903366 ManifestID: ActualCharge:120.23 PickupDate:10/28/2021 AccessTime:00:00 CarrierID:7459 Web_Dispatch:True EDI_Dispatch:False",
      "User": "Eric Intihar",
      "DateStamp": "2021-10-28T13:43:11",
      "NoteType": 7
    },
    {
      "Text": "",
      "User": "Eric Intihar",
      "DateStamp": "2021-10-28T13:43:11",
      "NoteType": 22
    },
    {
      "Text": "Load booked with Dayton Freight Standard.",
      "User": "Eric Intihar",
      "DateStamp": "2021-10-28T13:43:11",
      "NoteType": 10
    },
    {
      "Text": "<a href=javascript:ShowTerminalLink('7459','36887370')>Terminal Link</a>",
      "User": "Eric Intihar",
      "DateStamp": "2021-10-28T13:43:11",
      "NoteType": 19
    },
    {
      "Text": "Awarded quote email was not sent due to permissions.",
      "User": "Eric Intihar",
      "DateStamp": "2021-10-28T13:43:11",
      "NoteType": 7
    },
    {
      "Text": "Original shipperDateTime = 10/28/2021 Original consigneedatetime = 10/28/2021 New shipperDateTime = 10/28/2021 New consigneedatetime = 10/29/2021 ActualPickupDate = 10/28/2021 ActualDeliverDate = 10/29/2021",
      "User": "Automation",
      "DateStamp": "2021-10-28T13:43:11",
      "NoteType": 7
    },
    {
      "Text": "Override for 6629252 - Dayton Freight Standard<br />- Billing",
      "User": "Automation",
      "DateStamp": "2021-10-28T13:42:16",
      "NoteType": 7
    },
    {
      "Text": "Load Created",
      "User": "Eric Intihar",
      "DateStamp": "2021-10-28T13:41:31",
      "NoteType": 10
    },
    {
      "Text": "Original BOLID: BWS2130100010",
      "User": "Automation",
      "DateStamp": "2021-10-28T13:41:31",
      "NoteType": 7
    }
  ],
  "Errors": [],
  "Success": true
}
Modified at 2024-09-16 11:42:17
Previous
GetLoadDetails
Next
GetTrackingByLoad
Built with