Skip to main content
developer

GET: 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.

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

Request parameters

HTTP header Type Description
Accept string Required Specify request format (application/json, application/xml)
X-MyBring-API-Key string Required Your user’s API key
X-MyBring-API-Uid string Required Your Mybring login ID
Query param Type Description
additionalservice string Optional Additional service. Multiple value added services can be requested by repeating this parameter
addressline string Optional Specify address. This parameter can be maximum 35 character long. It will be for Bedriftspakke and På døren only.
Example: Testsvingen 12
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.
Example: CARGO-123456
date string Optional Shipping date
Example: 2018-11-18
edi boolean Optional Tells if the parcel will be registered using EDI when being booked. It may affect price and which services are available
Default value: true
estimateddeliverytime boolean Optional True if you want estimated delivery time of input pickup points. Eligible services are 5800 and SERVICEPAKKE.
fromcountry string Required Sender country code in valid ISO Alpha-2 format.
Example: NO
frompostalcode string Required Sender country code in valid ISO Alpha-2 format.
Example: NO
height integer Optional Package height in cm
incoterms string Optional Terms of delivery
language string Optional Language used for the service texts
Default value: no
length integer Optional Package length in cm
loadingmeter double Optional Package loading meters
nonstackable boolean Optional Set to true if you know that pallet would be non-stackable
nonstandardcourierservice string Required Specify service code for customize courier services in the request. It will be for NonStandard Courier only.
Example: CDA
numberofdeliverydates integer Optional Number of alternative delivery dates to be suggested by API for request
numberofpallets integer Optional Number of pallets.
payer string Optional Payer type. Possible values are SENDER, RECEIVER or THIRD_PARTY
pickuppoints string Optional If pickup points are specified then estimated delivery time will be added in the response for them, when estimateddeliverytime' flag is True. If it is not specified, then default pickup point(s) for receiver’s postal code will be used. Eligible services are 5800 and SERVICEPAKKE. However we recommend to always specify pickup points for optimum results.
Example: 171102,124518
postingatpostoffice boolean Optional Tells whether the parcel is delivered at a post office when it is shipped. A surcharge will be applied for SERVICEPAKKE and BPAKKE_DOR-DOR
product string Required List of services requested. Multiple services can be requested in a single request. Requested service can also be specified with a customer number separated with : (colon) as delimiter. For example CARGO:CARGO-123456
time string Optional Shipping time
Example: 12:30
tocountry string Required Receiver country code in valid ISO Alpha-2 format.
Example: NO
topostalcode string Required Receiver country code in valid ISO Alpha-2 format.
Example: NO
uniqueAlternateDeliveryDates boolean Optional True if you want unique expected delivery dates when requested with numberofdeliverydates.
unnumber integer Optional Code for dangerous goods
volumeSpecial boolean Optional True if the package has a shape that requires special handling
volumeindm3 integer Optional Package volume in dm3
weight integer Optional Package weight in grams
width integer Optional Package width in cm

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