Banyan Technology LIVE Connect™
  1. Booking
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
          POST
        • Unbooks the awarded quote on the specified load.
          POST
      • 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. Booking

Book a Shipment

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

Books an existing quote on the specified shipment.#

Reference the table below, as well as the supplied examples to see the different ways to use this endpoint.#

AttributeTypeDescription
DispatchboolDefaults to false. When true, the shipment will be moved to Dispatched status in Banyan.
SubmitPickupRequestboolDefaults to false. When true, a dispatch request will be sent to the carrier.
DispatchOverrideboolDefaults to false. When true, if the dispatch request fails, the shipment will still move to dispatched status.

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
Class BookQuoteRequest.
quoteId
integer <int32>
required
Quote's primary identifier (Banyan supplied)
acceptInsurance
boolean 
optional
Gets or sets a value indicating whether to accept associated insurance quote.
acceptCarbonService
boolean 
optional
Gets or sets a value indicating whether carbon services should be accepted. If false, carbon services will be removed from
the quote before booking if they exist. If true, carbon services will be purchased upon booking. This will cause an error
to be returned if set to true and carbon service information was not applied during rating, as re-rating needs to occur
to get the costs from the carbon vendor.
dispatch
boolean  | null 
optional
This field determines if the shipment should be set to Dispatched status in Banyan.
submitPickupRequest
boolean  | null 
optional
This field determines if a pickup request should be sent to the carrier the shipment is being booked with.
dispatchOverride
boolean  | null 
optional
When true, if the pickup request fails, the shipment will still move to dispatched status.
proNumber
string  | null 
optional
Sets the Pro Number of the shipment. If this field is provided, it will overwrite the existing pro number on the shipment.
emailBol
boolean 
optional
When true, a copy of the BOL will be emailed to the provided email address.
bolEmailAddress
string  | null 
optional
A comma separated list email addresses to send the BOL too when a shipment is booked. If not provided, the shipper contact email address will be used.
Example
{
  "quoteId": 0,
  "acceptInsurance": true,
  "acceptCarbonService": true,
  "dispatch": true,
  "submitPickupRequest": true,
  "dispatchOverride": true,
  "proNumber": "string",
  "emailBol": true,
  "bolEmailAddress": "string"
}

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//Book' \
--header 'Content-Type: application/json' \
--data-raw '{
    "quoteId": 0,
    "acceptInsurance": true,
    "acceptCarbonService": true,
    "dispatch": true,
    "submitPickupRequest": true,
    "dispatchOverride": true,
    "proNumber": "string",
    "emailBol": true,
    "bolEmailAddress": "string"
}'

Responses

🟢200Success
application/json
Body
Class ShipmentDto.
loadId
integer <int32>
required
Banyan's primary shipment identifier
status
enum<string> 
required
Description of current status
Allowed values:
PendingOpenQuotedBookedDispatchedIn TransitDeliveredCancelledDispatch RequestedDispatch FailedQuote Approval PendingApproval Denied
client
object (ClientDto) 
required
Client information for this shipment.
clientId
integer <int32>
optional
The unique id of this client in the Banyan system.
clientName
string  | null 
optional
Name of client that the shipment is under.
clientRefNumber
string  | null 
optional
The client ref number associated to this client.
awardedQuotePricing
object (AwardedQuotePricingDto) 
optional
Information about the awarded quote once a shipment has been booked.
raw
number <double>
optional
Quote raw price (returned from the carrier)
carrier
number <double>
optional
Quote carrier price (carrier markups applied)
customer
number <double>
optional
Quote customer price (customer markups applied)
quotes
array[object (QuoteDto) {21}]  | null 
optional
Gets or sets the quotes.
quoteId
integer <int32>
optional
Banyan's primary quote identifier
carrierName
string 
optional
Carrier name
carrierId
integer <int32>
optional
Banyan's primary carrier identifier
scac
string 
optional
Carrier standard carrier alpha code
thirdPartyName
string  | null 
optional
Typically set when the quote is from a 3PL. This will contain the 3pl carrier's name.
thirdPartyScac
string  | null 
optional
3PL standard carrier alpha code
serviceId
string  | null 
optional
Quote service identifier
rawPrice
object (QuotePriceDto) 
optional
Quote raw price (returned from the carrier)
carrierPrice
object (QuotePriceDto) 
optional
Quote carrier price (carrier markups applied)
customerPrice
object (QuotePriceDto) 
optional
Quote customer price (customer markups applied)
transitTime
integer <int32>
optional
Quote transit time
quoteNumber
string  | null 
optional
Carrier quote identifier
carrierPerson
string  | null 
optional
Carrier person
carrierNote
string  | null 
optional
Note returned by the carrier regarding the quote
dateStamp
string <date-time>
optional
Quote date
interline
boolean 
optional
Set to true only when confirmed to be interline
accepted
boolean 
optional
Quote has been accepted by client
currencyType
optional
Quote currency type
service
string  | null 
optional
Quote service
insuranceDetails
optional
Insurance Details related to the quote
accountNumber
string  | null 
optional
Account Number/ID used for Quote (if any)
notes
array[object (NoteDto) {4}]  | null 
optional
Shipment & carrier notes
description
string  | null 
optional
Note text
noteTypeId
integer <int32>
optional
Note Type Id
userName
string  | null 
optional
Note creator
dateStamp
string <date-time>
optional
Note date
manifestId
string  | null 
optional
Shipment PRO number
bolNumber
string  | null 
optional
Shipment BOL number
customerPo
string  | null 
optional
Shipment Customer PO
invoiceId
string  | null 
optional
Shipment Invoice identifier
billingId
string  | null 
optional
Shipment Billing identifier
incoTermId
integer <int32>
optional
Shipment IncoTerm identifier
pickupNumber
string  | null 
optional
Pickup number assigned to the load
shipperConfirmationNumber
string  | null 
optional
Gets or sets the shipper confirmation number.
consigneeConfirmationNumber
string  | null 
optional
Gets or sets the consignee confirmation number.
estimatedPickup
string <date-time> | null 
optional
Estimated Pickup Date
actualPickup
string <date-time> | null 
optional
Actual Pickup Date
estimatedDelivery
string <date-time> | null 
optional
Estimated Delivery Date
actualDelivery
string <date-time> | null 
optional
Actual Delivery Date
createdDate
string <date-time> | null 
optional
Shipment created date
shipType
enum<string> 
required
Shipment Ship Type
Allowed values:
ShipperConsigneeThirdParty
payType
enum<string> 
required
Shipment Pay Type
Allowed values:
CollectPrepaid
exportReason
string  | null 
optional
Gets or sets the Export Reason.
internationalTerm
string  | null 
optional
Gets or sets the International Term.
shipperLocation
object (LocationDto) 
optional
Shipper Information
companyName
string  | null 
optional
Company name
locationName
string  | null 
optional
Location name
einNumber
string  | null 
optional
The EIN Number of the location (if applicable)
note
string  | null 
optional
A note for the location
contactMethods
object (ContactMethodsDto) 
optional
Contact methods for the location.
contactPerson
object (ContactPersonDto) 
optional
Contact Person for the location
address
object (AddressDto) 
optional
Address information for the location.
vendorId
string  | null 
optional
Vendor identifier - Used to map to an existing vendor in Banyan.
The system will look up the vendor location and use that data instead of what is in the request.
distributionCenterReferenceNumber
string  | null 
optional
Distribution center identifier - Used to map to an existing distribution center in Banyan. This can further filter data for vendors with multiple locations.
dock
object (DockDetailsDto)  | null 
optional
Dock Information for the location.
consigneeLocation
object (LocationDto) 
optional
Consignee Information
billTo
object (BillToDto) 
optional
Billing Information
name
string  | null 
optional
Name of Bill To
<= 50 characters
contactMethods
object (ContactMethodsDto) 
optional
Bill To contact methods
note
string  | null 
optional
Note for Bill To
address
object (AddressDto) 
optional
Bill To Address information
packageInfo
object (PackageInfoDto) 
optional
Package Information
routeNumber
string  | null 
optional
Used to identify the route a driver will take when moving a package; used for Local Carrier
cod
number <double>
optional
Shipment collect on delivery amount
>= 0
declaredLiability
number <double>
optional
Shipment declared liability amount
>= 0
shipmentServices
array[object (ShipmentServiceDto) {8}]  | null 
optional
Shipment Service(s)
serviceMode
enum<string> 
required
The service mode of the shipment. Default: LTL
Allowed values:
Standard Parcel ServiceLTLVolumeAir CargoOcean FreightDrive AwayIntermodalOcean LCLAir InternationalInternational ExpeditedDomestic ExpeditedFull TruckloadBulkRailDrayageLocal CarrierExpeditedScheduledPartial TruckloadGFPSpot QuoteFinal Mile
quantity
integer <int32>
optional
Shipment shipping quantity
> 0
packageType
enum<string> 
required
The package type of the shipment. Default: Pallets
Allowed values:
ACCATTBAGSBALEBRRLBASKBINBOXSBUCKBHDSBNDLCARBCRTNCASECHSTCOILCTNCRTSCYLSDRUMEACHENVLPFEETFIRKGYLDKEGSLOOSOCTAPACKPAILPLTSPIECPCJCRACKREELROLLSKIDSLIPSPRSTOTETRLRTRYSTRCKTRNKTUBETUBSUNITSUNPKVHCL
equipmentType
enum<string> 
required
The equipment type of the shipment. Default: Van-standard trailer
Allowed values:
16ft Straight Truck18ft Straight Truck24ft Straight Truck24ft Straight Truck w/ lift gate26ft Straight Truck26ft Straight Truck w/ lift gate4x453ft - Van TrailerAir CargoALLBox truckBox truck w/ lift gateBulk TruckCarCar-CarrierCargo VanContainer - 20ftContainer - 40ftContainer - 40HQContainer - 45ftContainer - 53ftDouble DropDoublesDump TruckDumper - 20 yardDumper - 40 yardDumper - 60 yardDumper - 80 yardFlat BedFrozenFull Size VanGooseneckHopper BottomLow BoyMaxi TrailerMinivanOtherParcel TruckPickup TruckRail Car - 20ftRail Car - 40ftRail Car - 53ftRefrigeratedRemovable GooseneckRoll-off TruckSprinter VanStep DeckTankerTractorTractor TrailerTrailer – 24ftTrailer – 26ftTrailer – 28ftTrailer – 48ftTrailer – 53ftTri-Axle VanTruckTruck w/ lift gateVanVan w/ lift gateVan-standard trailerWalking FloorWinch Truck
additionalWeight
number <double>
optional
Shipment additional weight
>= 0
weightUnitOfMeasurement
optional
The weight unit of measurement for the shipment. Default: LBS
specialInstructions
string  | null 
optional
Shipment special instructions
dimensions
object (DimensionsDto) 
optional
Total shipment dimenstions
handlingUnits
array[object (HandlingUnitDto) {9}]  | null 
optional
The handling units containing product information.
packageType
enum<string> 
required
The package type for the handling unit. Pallets is the default value.
Allowed values:
ACCATTBAGSBALEBRRLBASKBINBOXSBUCKBHDSBNDLCARBCRTNCASECHSTCOILCTNCRTSCYLSDRUMEACHENVLPFEETFIRKGYLDKEGSLOOSOCTAPACKPAILPLTSPIECPCJCRACKREELROLLSKIDSLIPSPRSTOTETRLRTRYSTRCKTRNKTUBETUBSUNITSUNPKVHCL
quantity
integer <int32>
optional
The quanity of this hanlding unit.
length
number <double>
optional
The Length of the handling unit.
width
number <double>
optional
The width of the handling unit.
height
number <double>
optional
The height of the handling unit.
additionalWeight
number <double>
optional
Any additional weight added to the handling unit.
unitOfMeasurement
enum<string> 
optional
The unit of measurement for the size dimensions of the handling unit. Required if dimensions are provided.
Allowed values:
CMFTIN
weightUnitOfMeasurement
enum<string> 
optional
The unit of measurement for the Additional Weight of the handling unit.
Allowed values:
LBSKG
products
array[object (ProductDto) {13}] 
required
The individual products on the handling unit.
>= 1 items
loadAccessorials
array[object (ShipmentAccessorialDto) {3}]  | null 
optional
The shipment accessorials.
description
enum<string> 
optional
The full description of the accessorial
Allowed values:
Age RestrictedLight AssemblyBulkheadBindersCustoms In-BondBlanket Service - ChilledBlanket Service - FrozenBlind ShipmentProtect from FreezingChains RequiredExpeditedFood Grade ProductsGuaranteedHoliday DeliveryHoliday PickupOver DimensionUnattendedSingle ShipmentStackableStakes RequiredMust Be StrappedTanker Endorsed Driver RequiredTime DefiniteTurnkeyTSAVolume ShipmentWeight DeterminationNo SignatureProactive ResponseRestricted DeliveryReturn ReceiptRoom of ChoiceSaturday DeliveryShipper ReleaseShipment HoldSignature Required2nd ManSpecial HandlingThresholdWhite Glove
abbreviation
enum<string> 
optional
The abbreviation (code) of the accessorial
Allowed values:
AGE ASSEMBLKHDLBINDLBONDLBSCHLBSFZLBSHPLBSRVLCHAILEXPDLFGP LGUARLHDELLHPCKLODIMLPSLALSINGLSTACLSTAKLSTRALTEDRLTIMELTKEYLTSA LVSHPLWDETNOSG PRORERESDERETREROCH SATDESHIRESHLD SIGRQSMAN SPEHATHRS WGLV
value
string  | null 
optional
An optional value for the accessorial
shipperAccessorials
array[object (ShipmentAccessorialDto) {3}]  | null 
optional
The shipper accessorials.
description
enum<string> 
optional
The full description of the accessorial
Allowed values:
Age RestrictedLight AssemblyBulkheadBindersCustoms In-BondBlanket Service - ChilledBlanket Service - FrozenBlind ShipmentProtect from FreezingChains RequiredExpeditedFood Grade ProductsGuaranteedHoliday DeliveryHoliday PickupOver DimensionUnattendedSingle ShipmentStackableStakes RequiredMust Be StrappedTanker Endorsed Driver RequiredTime DefiniteTurnkeyTSAVolume ShipmentWeight DeterminationNo SignatureProactive ResponseRestricted DeliveryReturn ReceiptRoom of ChoiceSaturday DeliveryShipper ReleaseShipment HoldSignature Required2nd ManSpecial HandlingThresholdWhite Glove
abbreviation
enum<string> 
optional
The abbreviation (code) of the accessorial
Allowed values:
AGE ASSEMBLKHDLBINDLBONDLBSCHLBSFZLBSHPLBSRVLCHAILEXPDLFGP LGUARLHDELLHPCKLODIMLPSLALSINGLSTACLSTAKLSTRALTEDRLTIMELTKEYLTSA LVSHPLWDETNOSG PRORERESDERETREROCH SATDESHIRESHLD SIGRQSMAN SPEHATHRS WGLV
value
string  | null 
optional
An optional value for the accessorial
consigneeAccessorials
array[object (ShipmentAccessorialDto) {3}]  | null 
optional
The consignee accessorials.
description
enum<string> 
optional
The full description of the accessorial
Allowed values:
Age RestrictedLight AssemblyBulkheadBindersCustoms In-BondBlanket Service - ChilledBlanket Service - FrozenBlind ShipmentProtect from FreezingChains RequiredExpeditedFood Grade ProductsGuaranteedHoliday DeliveryHoliday PickupOver DimensionUnattendedSingle ShipmentStackableStakes RequiredMust Be StrappedTanker Endorsed Driver RequiredTime DefiniteTurnkeyTSAVolume ShipmentWeight DeterminationNo SignatureProactive ResponseRestricted DeliveryReturn ReceiptRoom of ChoiceSaturday DeliveryShipper ReleaseShipment HoldSignature Required2nd ManSpecial HandlingThresholdWhite Glove
abbreviation
enum<string> 
optional
The abbreviation (code) of the accessorial
Allowed values:
AGE ASSEMBLKHDLBINDLBONDLBSCHLBSFZLBSHPLBSRVLCHAILEXPDLFGP LGUARLHDELLHPCKLODIMLPSLALSINGLSTACLSTAKLSTRALTEDRLTIMELTKEYLTSA LVSHPLWDETNOSG PRORERESDERETREROCH SATDESHIRESHLD SIGRQSMAN SPEHATHRS WGLV
value
string  | null 
optional
An optional value for the accessorial
referenceFields
array[object (ReferenceFieldDto) {4}]  | null 
optional
The reference fields. These relate to custom reference fields set up on a client basis.
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
insuranceInfo
object (BanyanWebServices.Domain.Dtos.Shipment.InsuranceDto) 
optional
Shipment Insurance Details
vendor
string  | null 
optional
The vendor. This will match based on vendor name or code.
commodityType
string  | null 
optional
The commodity type. This will match based on name or code.
commodityCondition
string  | null 
optional
The commodity condition. This will match on name or code.
insuredValue
number <double> | null 
optional
The amount being insured.
stops
array[object (BanyanWebServices.Domain.Dtos.GetShipment.ShipmentDto) {43}]  | null 
optional
Individual stops for a multi-stop shipment
loadId
integer <int32>
required
Banyan's primary shipment identifier
status
enum<string> 
required
Description of current status
Allowed values:
PendingOpenQuotedBookedDispatchedIn TransitDeliveredCancelledDispatch RequestedDispatch FailedQuote Approval PendingApproval Denied
client
object (ClientDto) 
required
Client information for this shipment.
awardedQuotePricing
object (AwardedQuotePricingDto) 
optional
Information about the awarded quote once a shipment has been booked.
quotes
array[object (QuoteDto) {21}]  | null 
optional
Gets or sets the quotes.
notes
array[object (NoteDto) {4}]  | null 
optional
Shipment & carrier notes
manifestId
string  | null 
optional
Shipment PRO number
bolNumber
string  | null 
optional
Shipment BOL number
customerPo
string  | null 
optional
Shipment Customer PO
invoiceId
string  | null 
optional
Shipment Invoice identifier
billingId
string  | null 
optional
Shipment Billing identifier
incoTermId
integer <int32>
optional
Shipment IncoTerm identifier
pickupNumber
string  | null 
optional
Pickup number assigned to the load
shipperConfirmationNumber
string  | null 
optional
Gets or sets the shipper confirmation number.
consigneeConfirmationNumber
string  | null 
optional
Gets or sets the consignee confirmation number.
estimatedPickup
string <date-time> | null 
optional
Estimated Pickup Date
actualPickup
string <date-time> | null 
optional
Actual Pickup Date
estimatedDelivery
string <date-time> | null 
optional
Estimated Delivery Date
actualDelivery
string <date-time> | null 
optional
Actual Delivery Date
createdDate
string <date-time> | null 
optional
Shipment created date
shipType
enum<string> 
required
Shipment Ship Type
Allowed values:
ShipperConsigneeThirdParty
payType
enum<string> 
required
Shipment Pay Type
Allowed values:
CollectPrepaid
exportReason
string  | null 
optional
Gets or sets the Export Reason.
internationalTerm
string  | null 
optional
Gets or sets the International Term.
shipperLocation
object (LocationDto) 
optional
Shipper Information
consigneeLocation
object (LocationDto) 
optional
Consignee Information
billTo
object (BillToDto) 
optional
Billing Information
packageInfo
object (PackageInfoDto) 
optional
Package Information
shipmentServices
array[object (ShipmentServiceDto) {8}]  | null 
optional
Shipment Service(s)
handlingUnits
array[object (HandlingUnitDto) {9}]  | null 
optional
The handling units containing product information.
loadAccessorials
array[object (ShipmentAccessorialDto) {3}]  | null 
optional
The shipment accessorials.
shipperAccessorials
array[object (ShipmentAccessorialDto) {3}]  | null 
optional
The shipper accessorials.
consigneeAccessorials
array[object (ShipmentAccessorialDto) {3}]  | null 
optional
The consignee accessorials.
referenceFields
array[object (ReferenceFieldDto) {4}]  | null 
optional
The reference fields. These relate to custom reference fields set up on a client basis.
insuranceInfo
object (BanyanWebServices.Domain.Dtos.Shipment.InsuranceDto) 
optional
Shipment Insurance Details
stops
array[object (BanyanWebServices.Domain.Dtos.GetShipment.ShipmentDto) {43}]  | null 
optional
Individual stops for a multi-stop shipment
legs
array[object (BanyanWebServices.Domain.Dtos.GetShipment.ShipmentDto) {43}]  | null 
optional
Individual legs for a multi-legshipment
exported
boolean 
optional
Gets or sets a value indicating whether this BanyanWebServices.Domain.Dtos.GetShipment.ShipmentDto is exported.
isMultiStop
boolean 
read-onlyoptional
Gets a value indicating whether this instance is multi stop.
isMultiLeg
boolean 
read-onlyoptional
Gets a value indicating whether this instance is multi leg.
dispatchResponse
object (BanyanWebServices.Domain.Dtos.Shipment.DispatchResponseDto) 
optional
The standard dispatch response dto.
carbonQuote
object (BanyanWebServices.Domain.Dtos.Shipment.CarbonQuoteDto) 
optional
The carbon quote dto.
marketRates
array[object (BanyanWebServices.Domain.Dtos.Shipment.MarketRateDto) {8}]  | null 
optional
List of any MarketRates attached to a shipment
legs
array[object (BanyanWebServices.Domain.Dtos.GetShipment.ShipmentDto) {43}]  | null 
optional
Individual legs for a multi-legshipment
loadId
integer <int32>
required
Banyan's primary shipment identifier
status
enum<string> 
required
Description of current status
Allowed values:
PendingOpenQuotedBookedDispatchedIn TransitDeliveredCancelledDispatch RequestedDispatch FailedQuote Approval PendingApproval Denied
client
object (ClientDto) 
required
Client information for this shipment.
awardedQuotePricing
object (AwardedQuotePricingDto) 
optional
Information about the awarded quote once a shipment has been booked.
quotes
array[object (QuoteDto) {21}]  | null 
optional
Gets or sets the quotes.
notes
array[object (NoteDto) {4}]  | null 
optional
Shipment & carrier notes
manifestId
string  | null 
optional
Shipment PRO number
bolNumber
string  | null 
optional
Shipment BOL number
customerPo
string  | null 
optional
Shipment Customer PO
invoiceId
string  | null 
optional
Shipment Invoice identifier
billingId
string  | null 
optional
Shipment Billing identifier
incoTermId
integer <int32>
optional
Shipment IncoTerm identifier
pickupNumber
string  | null 
optional
Pickup number assigned to the load
shipperConfirmationNumber
string  | null 
optional
Gets or sets the shipper confirmation number.
consigneeConfirmationNumber
string  | null 
optional
Gets or sets the consignee confirmation number.
estimatedPickup
string <date-time> | null 
optional
Estimated Pickup Date
actualPickup
string <date-time> | null 
optional
Actual Pickup Date
estimatedDelivery
string <date-time> | null 
optional
Estimated Delivery Date
actualDelivery
string <date-time> | null 
optional
Actual Delivery Date
createdDate
string <date-time> | null 
optional
Shipment created date
shipType
enum<string> 
required
Shipment Ship Type
Allowed values:
ShipperConsigneeThirdParty
payType
enum<string> 
required
Shipment Pay Type
Allowed values:
CollectPrepaid
exportReason
string  | null 
optional
Gets or sets the Export Reason.
internationalTerm
string  | null 
optional
Gets or sets the International Term.
shipperLocation
object (LocationDto) 
optional
Shipper Information
consigneeLocation
object (LocationDto) 
optional
Consignee Information
billTo
object (BillToDto) 
optional
Billing Information
packageInfo
object (PackageInfoDto) 
optional
Package Information
shipmentServices
array[object (ShipmentServiceDto) {8}]  | null 
optional
Shipment Service(s)
handlingUnits
array[object (HandlingUnitDto) {9}]  | null 
optional
The handling units containing product information.
loadAccessorials
array[object (ShipmentAccessorialDto) {3}]  | null 
optional
The shipment accessorials.
shipperAccessorials
array[object (ShipmentAccessorialDto) {3}]  | null 
optional
The shipper accessorials.
consigneeAccessorials
array[object (ShipmentAccessorialDto) {3}]  | null 
optional
The consignee accessorials.
referenceFields
array[object (ReferenceFieldDto) {4}]  | null 
optional
The reference fields. These relate to custom reference fields set up on a client basis.
insuranceInfo
object (BanyanWebServices.Domain.Dtos.Shipment.InsuranceDto) 
optional
Shipment Insurance Details
stops
array[object (BanyanWebServices.Domain.Dtos.GetShipment.ShipmentDto) {43}]  | null 
optional
Individual stops for a multi-stop shipment
legs
array[object (BanyanWebServices.Domain.Dtos.GetShipment.ShipmentDto) {43}]  | null 
optional
Individual legs for a multi-legshipment
exported
boolean 
optional
Gets or sets a value indicating whether this BanyanWebServices.Domain.Dtos.GetShipment.ShipmentDto is exported.
isMultiStop
boolean 
read-onlyoptional
Gets a value indicating whether this instance is multi stop.
isMultiLeg
boolean 
read-onlyoptional
Gets a value indicating whether this instance is multi leg.
dispatchResponse
object (BanyanWebServices.Domain.Dtos.Shipment.DispatchResponseDto) 
optional
The standard dispatch response dto.
carbonQuote
object (BanyanWebServices.Domain.Dtos.Shipment.CarbonQuoteDto) 
optional
The carbon quote dto.
marketRates
array[object (BanyanWebServices.Domain.Dtos.Shipment.MarketRateDto) {8}]  | null 
optional
List of any MarketRates attached to a shipment
exported
boolean 
optional
Gets or sets a value indicating whether this BanyanWebServices.Domain.Dtos.GetShipment.ShipmentDto is exported.
isMultiStop
boolean 
read-onlyoptional
Gets a value indicating whether this instance is multi stop.
isMultiLeg
boolean 
read-onlyoptional
Gets a value indicating whether this instance is multi leg.
dispatchResponse
object (BanyanWebServices.Domain.Dtos.Shipment.DispatchResponseDto) 
optional
The standard dispatch response dto.
loadId
integer <int32>
optional
Gets or sets the load id.
success
boolean 
optional
Gets or sets a flag indicating if the dispatch request succeeded.
pickupNumber
string  | null 
optional
Gets or sets the pickup number.
carrierName
string  | null 
optional
Gets or sets the carrier name.
quoteNumber
string  | null 
optional
Gets or sets the quote number.
estimatedDeliveryDate
string <date-time> | null 
optional
Gets or sets the estimated delivery date.
proNumber
string  | null 
optional
Gets or sets the pro number.
userMessage
string  | null 
optional
Gets or sets the user message.
bolLink
string  | null 
optional
Gets or sets the BOL Link.
warnings
array[string] | null 
optional
Gets or sets the warnings.
errors
array[string] | null 
optional
Gets or sets a collection of error messages.
carbonQuote
object (BanyanWebServices.Domain.Dtos.Shipment.CarbonQuoteDto) 
optional
The carbon quote dto.
offsetAmount
number <double>
optional
The amount of carbon that will be offset in BanyanWebServices.Domain.Dtos.Shipment.CarbonQuoteDto.OffsetUnit.
offsetUnit
string  | null 
optional
The unit the BanyanWebServices.Domain.Dtos.Shipment.CarbonQuoteDto.OffsetAmount is in.
estimatedPrice
number <double>
optional
The estimated price of offsetting the carbon.
vendorFee
number <double>
optional
The vendor fee.
currency
string  | null 
optional
The currency monetary values are in.
orderId
string  | null 
optional
The order identifier.
marketRates
array[object (BanyanWebServices.Domain.Dtos.Shipment.MarketRateDto) {8}]  | null 
optional
List of any MarketRates attached to a shipment
vendorName
string  | null 
optional
Name of Vendor
highBuyRate
number <double> | null 
optional
High Buy Rate Recommendation of Vendor
lowBuyRate
number <double> | null 
optional
Low Buy Rate Recommendation of Vendor
buyRate
number <double> | null 
optional
Target Buy Rate Recommendation of Vendor
startRate
number <double> | null 
optional
Starting Bid Recommandation of Vendor
confidenceLevel
integer <int32> | null 
optional
Confidence of Vendor to hit target rate
currency
string  | null 
optional
The currency of the Market Rate.
date
string <date-time> | null 
optional
The date the Market Rate was generated.
Example
{
  "loadId": 0,
  "status": "Pending",
  "client": {
    "clientId": 0,
    "clientName": "string",
    "clientRefNumber": "string"
  },
  "awardedQuotePricing": {
    "raw": 0,
    "carrier": 0,
    "customer": 0
  },
  "quotes": [
    {
      "quoteId": 0,
      "carrierName": "string",
      "carrierId": 0,
      "scac": "string",
      "thirdPartyName": "string",
      "thirdPartyScac": "string",
      "serviceId": "string",
      "rawPrice": {
        "netPrice": 0,
        "freightCharge": 0,
        "discountAmount": 0,
        "fuelSurcharge": 0,
        "minimum": 0,
        "grossCharge": 0,
        "tariff": 0,
        "interline": 0,
        "accessorialCharges": 0,
        "otherCharges": 0,
        "charges": [
          {
            "name": "string",
            "amount": 0,
            "code": "string"
          }
        ],
        "markup": 0
      },
      "carrierPrice": {
        "netPrice": 0,
        "freightCharge": 0,
        "discountAmount": 0,
        "fuelSurcharge": 0,
        "minimum": 0,
        "grossCharge": 0,
        "tariff": 0,
        "interline": 0,
        "accessorialCharges": 0,
        "otherCharges": 0,
        "charges": [
          {
            "name": "string",
            "amount": 0,
            "code": "string"
          }
        ],
        "markup": 0
      },
      "customerPrice": {
        "netPrice": 0,
        "freightCharge": 0,
        "discountAmount": 0,
        "fuelSurcharge": 0,
        "minimum": 0,
        "grossCharge": 0,
        "tariff": 0,
        "interline": 0,
        "accessorialCharges": 0,
        "otherCharges": 0,
        "charges": [
          {
            "name": "string",
            "amount": 0,
            "code": "string"
          }
        ],
        "markup": 0
      },
      "transitTime": 0,
      "quoteNumber": "string",
      "carrierPerson": "string",
      "carrierNote": "string",
      "dateStamp": "2019-08-24T14:15:22Z",
      "interline": true,
      "accepted": true,
      "currencyType": "USDollar",
      "service": "string",
      "insuranceDetails": {
        "price": 0,
        "confirmation": "string",
        "insuranceNote": "string",
        "expirationDate": "2019-08-24T14:15:22Z",
        "deductible": "string",
        "termsAndConditions": "string",
        "vendorCode": "string"
      },
      "accountNumber": "string"
    }
  ],
  "notes": [
    {
      "description": "string",
      "noteTypeId": 0,
      "userName": "string",
      "dateStamp": "2019-08-24T14:15:22Z"
    }
  ],
  "manifestId": "string",
  "bolNumber": "string",
  "customerPo": "string",
  "invoiceId": "string",
  "billingId": "string",
  "incoTermId": 0,
  "pickupNumber": "string",
  "shipperConfirmationNumber": "string",
  "consigneeConfirmationNumber": "string",
  "estimatedPickup": "2019-08-24T14:15:22Z",
  "actualPickup": "2019-08-24T14:15:22Z",
  "estimatedDelivery": "2019-08-24T14:15:22Z",
  "actualDelivery": "2019-08-24T14:15:22Z",
  "createdDate": "2019-08-24T14:15:22Z",
  "shipType": "Shipper",
  "payType": "Collect",
  "exportReason": "string",
  "internationalTerm": "string",
  "shipperLocation": {
    "companyName": "string",
    "locationName": "string",
    "einNumber": "string",
    "note": "string",
    "contactMethods": {
      "phoneNumber": "string",
      "extension": "string",
      "faxNumber": "string",
      "email": "string"
    },
    "contactPerson": {
      "firstName": "string",
      "lastName": "string"
    },
    "address": {
      "lineOne": "string",
      "lineTwo": "string",
      "city": "string",
      "stateOrProvince": "string",
      "zipCode": "string",
      "country": "string"
    },
    "vendorId": "string",
    "distributionCenterReferenceNumber": "string",
    "dock": {
      "name": "string",
      "note": "string",
      "confirmationNumber": "string",
      "openTime": "2019-08-24T14:15:22Z",
      "accessTime": "2019-08-24T14:15:22Z",
      "closeTime": "2019-08-24T14:15:22Z",
      "isFirstComeFirstServe": true,
      "limitedAccessType": "Airport"
    }
  },
  "consigneeLocation": {
    "companyName": "string",
    "locationName": "string",
    "einNumber": "string",
    "note": "string",
    "contactMethods": {
      "phoneNumber": "string",
      "extension": "string",
      "faxNumber": "string",
      "email": "string"
    },
    "contactPerson": {
      "firstName": "string",
      "lastName": "string"
    },
    "address": {
      "lineOne": "string",
      "lineTwo": "string",
      "city": "string",
      "stateOrProvince": "string",
      "zipCode": "string",
      "country": "string"
    },
    "vendorId": "string",
    "distributionCenterReferenceNumber": "string",
    "dock": {
      "name": "string",
      "note": "string",
      "confirmationNumber": "string",
      "openTime": "2019-08-24T14:15:22Z",
      "accessTime": "2019-08-24T14:15:22Z",
      "closeTime": "2019-08-24T14:15:22Z",
      "isFirstComeFirstServe": true,
      "limitedAccessType": "Airport"
    }
  },
  "billTo": {
    "name": "string",
    "contactMethods": {
      "phoneNumber": "string",
      "extension": "string",
      "faxNumber": "string",
      "email": "string"
    },
    "note": "string",
    "address": {
      "lineOne": "string",
      "lineTwo": "string",
      "city": "string",
      "stateOrProvince": "string",
      "zipCode": "string",
      "country": "string"
    }
  },
  "packageInfo": {
    "routeNumber": "string",
    "cod": 0,
    "declaredLiability": 0
  },
  "shipmentServices": [
    {
      "serviceMode": "Standard Parcel Service",
      "quantity": 1,
      "packageType": "ACC",
      "equipmentType": "16ft Straight Truck",
      "additionalWeight": 0,
      "weightUnitOfMeasurement": "LBS",
      "specialInstructions": "string",
      "dimensions": {
        "unitOfMeasurement": "CM",
        "length": 0,
        "width": 0,
        "height": 0
      }
    }
  ],
  "handlingUnits": [
    {
      "packageType": "ACC",
      "quantity": 0,
      "length": 0,
      "width": 0,
      "height": 0,
      "additionalWeight": 0,
      "unitOfMeasurement": "CM",
      "weightUnitOfMeasurement": "LBS",
      "products": [
        {
          "packageType": "ACC",
          "quantity": 1,
          "class": 0,
          "weight": 1,
          "weightUnitOfMeasurement": "LBS",
          "dimensions": {
            "unitOfMeasurement": "CM",
            "length": 0,
            "width": 0,
            "height": 0
          },
          "nmfc": "string",
          "description": "string",
          "sku": "string",
          "referenceNumber": "string",
          "hazmatDetails": {
            "name": "string",
            "contactMethods": {
              "phoneNumber": "string",
              "extension": "string",
              "faxNumber": "string",
              "email": "string"
            },
            "isPoison": true,
            "unNumber": "string",
            "shippingName": "string",
            "class": "string",
            "packageGroup": "string"
          },
          "isHazmat": true,
          "internationalDetails": {
            "harmonizedSystemCode": "string",
            "systemBCode": "string",
            "eccn": "string"
          }
        }
      ]
    }
  ],
  "loadAccessorials": [
    {
      "description": "Age Restricted",
      "abbreviation": "AGE  ",
      "value": "string"
    }
  ],
  "shipperAccessorials": [
    {
      "description": "Age Restricted",
      "abbreviation": "AGE  ",
      "value": "string"
    }
  ],
  "consigneeAccessorials": [
    {
      "description": "Age Restricted",
      "abbreviation": "AGE  ",
      "value": "string"
    }
  ],
  "referenceFields": [
    {
      "type": "string",
      "value": "string",
      "printOnBol": true,
      "printOnShippingLabel": true
    }
  ],
  "insuranceInfo": {
    "vendor": "string",
    "commodityType": "string",
    "commodityCondition": "string",
    "insuredValue": 0
  },
  "stops": [
    {}
  ],
  "legs": [
    {}
  ],
  "exported": true,
  "isMultiStop": true,
  "isMultiLeg": true,
  "dispatchResponse": {
    "loadId": 0,
    "success": true,
    "pickupNumber": "string",
    "carrierName": "string",
    "quoteNumber": "string",
    "estimatedDeliveryDate": "2019-08-24T14:15:22Z",
    "proNumber": "string",
    "userMessage": "string",
    "bolLink": "string",
    "warnings": [
      "string"
    ],
    "errors": [
      "string"
    ]
  },
  "carbonQuote": {
    "offsetAmount": 0,
    "offsetUnit": "string",
    "estimatedPrice": 0,
    "vendorFee": 0,
    "currency": "string",
    "orderId": "string"
  },
  "marketRates": [
    {
      "vendorName": "string",
      "highBuyRate": 0,
      "lowBuyRate": 0,
      "buyRate": 0,
      "startRate": 0,
      "confidenceLevel": 0,
      "currency": "string",
      "date": "2019-08-24T14:15:22Z"
    }
  ]
}
🟠400Bad request
🟠401Unauthorized
🟠403Forbidden
🟠404Not Found
🟠422Client Error
🟠429Too Many Requests
Previous
Get documents for the specified shipment.
Next
Unbooks the awarded quote on the specified load.
Built with