Skip to main content
developer

POST: Get shipment prices and leadtime

Use this endpoint to get expected delivery, service categories and additional information.

Measurements

For cargo services(5100, 5300, 9100, CARGO), Weight is mandatory and one of the Volume / Load Meter / Dimensions / Number of Pallets is mandatory.

Note: The prices for our revised services depends on volumetric weight: 5000, 5100, 5300, 5600, 5800, 4850 plus return services 9000, 9100, 9300 or 9600. For these services, dimensions (L/W/H) is needed to calculate the expected price correctly. Dimensions are also used to decide if handling fee or specialgoods fee will apply to the shipment. You might leave dimensions empty in your request, but be aware that returned prices might be incorrect.

REST POST vs GET

There is both a POST and a GET endpoint for REST. We recommend using the POST endpoint over the GET one, as this is more likely to get all new features.

      POST
      https://api.bring.com/shippingguide/v2/products
    

Request parameters

HTTP header Type Description
Content-Type string Required application/json
X-MyBring-API-Key string Required Your user’s API key
X-MyBring-API-Uid string Required Your Mybring login ID

Request body

Body param Type Description
consignments array Required A list of consignment objects
id integer
products array Required List of products to include in response
id integer Required Product id. You can list available products with the /customers endpoint.
Example: BPAKKE_DOR-DOR
customerNumber string Optional Lets you specify which customer number to use in the request. If specified and service is not supplied with delimited customer number, then it will be applied on all request services
Required if estimateddeliverytime is set to true
packages array Required List of package specific information.
length integer Optional Package length in cm
width integer Optional Package height in cm
height integer Optional Package width in cm
grossWeight integer Required Package weight in grams
volumeInDm3 integer Optional Package volume in dm3
id integer
fromCountryCode string Required Sender country code in valid ISO Alpha-2 format.
Example: NO
toCountryCode string Required Receiver country code in valid ISO Alpha-2 format.
Example: NO
fromPostalCode string Required Sender postal code in valid ISO Alpha-2 format.
Example: NO
toPostalCode string Required Receiver postal code in valid ISO Alpha-2 format.
Example: NO
additionalServices array Optional List of value added services. Multiple value added services can be requested by repeating this parameter.
shippingDate object Optional Shipping date
year string Optional Example: 2021
month string Optional Example: 01
day string Optional Example: 29
hour string Optional Example: 06
minute string Optional Example: 54
withPrice boolean
withExpectedDelivery boolean True if you want estimated delivery time of input pickup points. Eligible services are 5800 and SERVICEPAKKE.
withGuiInformation boolean True if you want names and descriptions of products
edi boolean Optional Tells if the parcel will be registered using EDI when being booked. It may affect price and which services are available
trace boolean

Success response (200)

Param Type Description
traceMessages Array
consignments Array List of consignment objects
products Array List of products
id String Product ID
customerNumber String The customer number the product are tied to
productionCode String
guiInformation Object List of help texts and names to use in GUI
sortOrder String
mainDisplayCategory String Example: Parcel, Cargo...
subDisplayCategory String Example: To Private or To Business
displayName String Name to display in GUI
productName String The name of the product
descriptionText String A description of the product to the end customer
helpText String Instructions on how to use the product
shortName String A short version of the product name
productURL String A link to the product page
deliveryType String Delivery type, example: mailbox, pickup point
maxWeightInKgs String The maximum allowed weight for the product
price Object List of prices
listPrice
netPrice
Object List of list prices
priceWithoutAdditionalServices
priceWithAdditionalServices
Object Prices including and excluding cost of value added services
amountWithoutVAT Double Total price, VAT excluded
amountWithVAT Double Total price, VAT included
vat Double Total VAT
currencyCode String Currency code, example: NOK
expectedDelivery Object List of shipping estimate details
workingDays Integer Estimated number of working days to fulfill shipment
userMessage String
formattedExpectedDeliveryDate String Estimated delivery date in the following format: 'DD.MM.YYYY'
expectedDeliveryDate Object Estimated delivery date as separate keys
year Integer Estimated delivery year
month Integer Estimated delivery month
day Integer Estimated delivery day
alternativeDeliveryDates Array List of alternate delivery dates
shippingDate Object Alternate shipping date as separate keys
year Integer Estimated delivery year
month Integer Estimated delivery month
day Integer Estimated delivery day
formattedExpectedDeliveryDate String Estimated delivery date in the following format: 'DD.MM.YYYY'
expectedDeliveryDate Object Estimated delivery date as separate keys
year Integer Estimated delivery year
month Integer Estimated delivery month
day Integer Estimated delivery day
uniqueId String Unique response ID

Error response

User error (400)

This can mean that a required field or parameter has not been provided, the value supplied is invalid, or the combination of provided fields is invalid.

Param Type Description
fieldErrors Array List of field errors
code String Error code
message String Error message
field String Error in field. Returns an empty string if not related to a field.

Unauthorized (401)

A failed response when the request is unauthenticated