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
          POST
        • Update a Shipment
          PUT
        • Adds one or more Reference Numbers to a Shipment
          POST
        • Mark as Exported
          POST
      • 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
        • 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

Adds one or more Reference Numbers to a Shipment

POST
/api/v3/shipments/{Id}/referencenumbers
Shipments

Adds reference numbers to the specified Shipment by its id.#

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Path Params
Id
integer 
required
The Id of the entity the request relates to.
Body Params application/json
The create reference number request.
referenceFields
array[object (ReferenceFieldDto) {4}] 
required
The reference fields to create.
>= 1 items
type
string 
required
The type of the Reference field
>= 1 characters<= 250 characters
value
string 
required
The actual value of the Reference field
>= 1 characters<= 250 characters
printOnBol
boolean 
optional
If true, this reference field will be printed on the shipments BOL
printOnShippingLabel
boolean 
optional
If true, this reference field will be printed on the shipments Shipping Label
Example
{
  "referenceFields": [
    {
      "type": "string",
      "value": "string",
      "printOnBol": true,
      "printOnShippingLabel": true
    }
  ]
}

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/api/v3/shipments//referencenumbers' \
--header 'Content-Type: application/json' \
--data-raw '{
    "referenceFields": [
        {
            "type": "string",
            "value": "string",
            "printOnBol": true,
            "printOnShippingLabel": true
        }
    ]
}'

Responses

🟢200Success
application/json
Body
array of:
type
string 
required
The type of the Reference field
>= 1 characters<= 250 characters
value
string 
required
The actual value of the Reference field
>= 1 characters<= 250 characters
printOnBol
boolean 
optional
If true, this reference field will be printed on the shipments BOL
printOnShippingLabel
boolean 
optional
If true, this reference field will be printed on the shipments Shipping Label
Example
[
  {
    "type": "string",
    "value": "string",
    "printOnBol": true,
    "printOnShippingLabel": true
  }
]
🟠400Bad Request
🟠401Unauthorized
🟠403Forbidden
🟠404Not Found
🟠429Too Many Requests
Modified at 2024-09-16 11:42:17
Previous
Update a Shipment
Next
Mark as Exported
Built with