Skip to main content

Shipping Guide API

Updates

Shipping Guide API – Temporary closure of service 0336 Business Pallet NO-FI 13 August 2026Important

We are temporarily closing service 0336 Business Pallet for shipments from Norway to Finland, effective today.

Any shipments booked on this service will be returned.

Please contact your regular sales representative if you have any questions.

Shipping Guide API – Decommissioning of bulk services NO-FI 6 July 2026Important

Following the decommissioning of Bring’s terminal operations in Finland, bulk shipments from Norway to Finland are no longer supported through this route. As part of this transition, we are closing down the following services, effective today:

  • 0332 Business Parcel Bulk NO-FI
  • 0342 PickUp Parcel Bulk NO-FI

Any bulk shipments booked on these services will be returned as pallet.

We recommend switching to single-parcel services for shipments to Finland going forward.

Please contact your regular sales representative if you have any questions.

Shipping Guide API – Deprecation of path suffix based content negotiation 19 June 2026Important

Support for content negotiation using URL path suffixes .json or .xml (for example /api/v2/products.json and /api/v2/products.xml) is deprecated and will be removed in a future release.

Recommended Alternative

Clients should instead specify the desired response format using the HTTP Accept header:

JSON:

POST /api/v2/products
Accept: application/json

XML:

POST /api/v2/products
Accept: application/xml

Why This Change?

Path suffix-based content negotiation is no longer recommended and is not supported by default in newer versions of the underlying framework. Continuing to support this behavior requires custom compatibility code that will be removed in a future release.

Using standard HTTP content negotiation via the Accept header improves interoperability, aligns with current web standards, and ensures compatibility with future platform upgrades.

Removal Timeline

Support for .json and .xml URL suffixes is not yet scheduled for removal in a future release, but we recommend updating all integrations as soon as possible to avoid service disruption.

Older updates
Shipping Guide API – Parcel Lockers SE (0344) coverage area 19 May 2026

From today, the coverage area for the service Parcel Lockers SE (0344) has been updated to improve the customer experience by only depicting relevant pickup points in SE.

A request example is available on the Developer site under Shipping Guide API → “Fetch shipping details”. If a postal code is not covered, the API will return a validation error in the response.

Please reach out to your sales representative/integration contact if you have any questions.

Shipping Guide API – Express Nordic 09.00 (0335) decommissioning 12 May 2026Important

On 1 September 2026, Bring is decommissioning the service Express Nordic 09.00 (0335).

We strongly recommend transitioning to start using the alternative service from Bring Courier & Express (3620 + VAS 1171) as soon as possible, as requesting 0335 will not be possible after this date.

Please contact your regular sales representative if you have any questions.

Shipping Guide API – Decommissioning of services sent from Finland (except returns) 11 May 2026Important

Bring has decided to discontinue its own terminal operations in Finland. As a result, services for parcels and pallets sent from Finland will be decommissioned from 27 May 2026, except for return services.

You can still purchase services for parcels and pallets sent to Finland, which will continue to be delivered through our partner. No changes are required for these flows

The following services will be decommisioned:

  • 0330 Business Parcel FI-XX
  • 0340 Pickup Parcel FI-XX
  • 0349 Home Delivery Parcel FI-FI

Please contact your regular sales representative if you have any questions.

Shipping Guide API – Shipping Guide API - Home mailbox parcel (3584) & Home mailbox parcel RFID (3570) – Change of default fallback delivery 21 January 2026Important

From 26.01.2026, the default fallback behaviour for Home mailbox parcel will change.

If the shipment does not fit in the recipient’s mailbox, the parcel will by default be left outside the recipient’s door.

Previously, the default fallback was delivery to pickup point.

What this means for you

VAS 1081 (Delivery outside the door) is no longer required in the request.

Recipients can still change delivery preferences in the Posten app.

Shipping Guide API - Decomissioning of services from 01.01.2026 5 December 2025Important

Bring is commercially discontinuing the below service/country combinations from 01.01.2026, and support in APIs will be taken down shortly thereafter:

  • All outbound Heavy home delivery (+35 kg) services to/in Denmark, and returns from/in Denmark
  • Home Delivery Mailbox (0345) to/in Sweden
  • Non-standard and legacy Courier services (non-4-digit ones) to all countries
  • Express Nordic 09.00 Bulk (0334) to all countries
System maintenance 21 October 2025General

On 26 October we will do some system maintenance that will affect our APIs. You might experience some outage between 07:00 and 09:00 Sunday 26 October.

Important Update! New TLS certificates on api.bring.com 27th of October 2025 26 September 2025General

Migration from Buypass to Let’s Encrypt TLS Certificates As of 15 September 2025, Buypass has stopped allowing registration of new ACME Account and will stop generating/renewing TLS certificates from 15th October 2025. To ensure continuity, we are migrating all TLS certificates from Buypass to Let´s Encrypt.

As part of this activity:

  • Old Buypass certificates will be removed
  • New Let´s Encrypt certificates will be created

Impact to Customers:

  • If your application does not pin the certificate, no action is required and there will be zero impact.
  • If your application does pin the certificate, you will need to download the new Let´s Encrypt certificate and update your application configuration accordingly.

We recommend reviewing your applications to check whether certificate pinning is in place and preparing for updates if needed.

For more queries, contact integrasjon.norge@bring.com (Norway) or edi@bring.com (outside Norway).

Shipping Guide API - Return mailbox parcel (9650) decommissioning 25 August 2025Important

On September 1, Bring is decommissioning the service Return mailbox parcel (9650).

We strongly recommend transitioning to start using alternative return services in Norway (9350, 9300) as soon as possible, as requesting 9650 will not be possible shortly after this date.

Shipping Guide API - Service text updates 7 June 2024

In the coming weeks, we will be enhancing the service texts within the Shipping Guide API.

These updates relates to how the delivery options are described in checkout. The texts are updated with the latest information about each delivery option, and will be available in Norwegian, Swedish, Danish, and English.

We will update the text for the dynamic fields: displayName, descriptionText, helpText, and shortName. If you currently use these fields, no action is required. The structure and fields will remain unchanged; only the dynamic text will be updated.

For those not currently using these fields, we recommend utilize them to optimize your checkout. In the API, text related to delivery option will reflect the latest changes and ensuring that your customers receive accurate information about each delivery option.

Shipping Guide API - Deprecation of SOAP endpoint 10 May 2024

The SOAP endpoint is now deprecated. Going forward the API will only support application/json and application/xml as Content-Type.

If you are currently relying on the SOAP endpoint of Shippingguide API, you have until 1 October 2024 to migrate to the JSON/XML over HTTP based endpoints.

We will start rate limiting requests to the SOAP endpoint from 1 September 2024, with gradually reduced request rate until 1 October. This means that you will risk rejected requests because of rate limiting after 1 September

→ All updates

The Shipping Guide API provides available services for a given combination of sender and recipient locations, including estimated delivery times, prices and environmental data. It also returns logo and human readable service descriptions that can be shown in your checkout. Available services are based on your agreement with Bring (i.e. the customer numbers attached to your user).

Authentication

To integrate with the Bring APIs, you will need a Mybring user account with an API key. Information about prerequisites and authentication headers can be found on the general API Getting Started page.

Rate limiting

Clients exceeding 120 requests per second will be throttled, and the response will contain http status code 429. If you have a use case requiring rates above the limit, please contact developer-booking@bring.com for assistance.

Formats

Both XML and JSON over HTTP. The POST requests can be used for multiple consignments.

Special topics

Tips and guides

The importance of provided shipping date

Providing the actual shipping date in the request is a prerequisite for getting the correct lead times, as the lead time is always calculated from the day and time when the parcel arrives at a Bring terminal. It is recommended to read this guide for a better understanding of how the provided shipping date affects the returned lead time.

NOTE: In absence of a shipping date set by the user, the Shipping Guide API will default to now. If shipping date is set to now, lead times will be calculated on the assumption that the packages has just arrived at a terminal.

Holidays, weekends and lead time

When lead times are calculated, the returned estimates are always adjusted for weekends and official holidays. You will therefore never receive an estimate on a date we do not deliver. You can trust that the returned estimates are as accurate as possible.

NOTE: The provided shipping date is never adjusted for weekends and holidays. If you provide a shipping date that happens to be a sunday, the returned lead time would still be calculated with this date as the time the parcel has arrived at a terminal.

Endpoints

Base URL
http://api.bring.com/shippingguide
Usage Method Endpoint
Fetch shipping details POST /api/v2/products

Fetch shipping details

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

Use this endpoint to get expected delivery, prices, 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.

Request

header parameters

X-Mybring-API-Uid
Required
Description
Mybring login ID
Type
string
X-Mybring-API-Key
Required
Description
Your user's API key
Type
string
Accept
Description
Desired output media type
Type
string
Enum
application/json
application/xml
Default
application/json

Body schema

Required
List of consignments
array of objects
additionalServices
Additional services to be added
array
addressLine
The street name and number the consignment is to be delivered to
string
dangerousGoods
If dangerous goods are to be part of the consignment, the ADR-code(s) specifying the dangerous goods type(s) has to be provided
fromCountryCode
Required
Two-letter ISO-3166-1 country code of which consignment is sent from
string
fromPostalCode
Required
The postal code the consignment is sent from
string
id
Your internal reference to this consignment (you may calculate several consignment at the same time)
string
incoterms
International commercial terms
string
packages
Required
List of all packages in the consignment
array
pickupPointId
The pickup point id to which the consignment is to be shipped to. Only relevant for parcel products
string
pickupPoints
List of pickup points for which estimated delivery time should be calculated for (if varue of 'WithEstimatedDeliveryTime' is true). If not provided, the default pickup point for the receiver's postal code will be used.
array
products
Required
List of all services price and lead times should be calculated for
array
shippingDate
The date (and optionally time) the consignment will be shipped (used for computing estimated delivery date). NOTE: The lead time calculation interprets the provided date & time as the time when the consignment has been scanned at the terminal. If not provided, now() will be used
toCity
The city the consignment is to be delivered to
string
toCountryCode
Required
Two-letter ISO-3166-1 country code of which consignment is sent to
string
toPostalCode
Required
The postal code the consignment is to be delivered to
string
edi
Should the parcel be registered using EDI when shipped. Note that this flag may affect price and which services are available
boolean
language
Language in which human-readable message should be returned.
string
Enum
NO (default)
SE
SV
DA
EN
numberOfAlternativeDeliveryDates
Number of alternative delivery dates to be suggested
integer <int32>
postingAtPostoffice
Will the parcel be delivered at a post office when shipped
boolean
withEnvironmentalData
Return environmental data about fossil free and electric transportation used on the shipments transport legs
boolean
withEstimatedDeliveryTime
Extended lead time information, including predicted arrivar time at pickup point. Only supported for a limited set of services
boolean
withExpectedDelivery
Controls whether lead times should be calculated or not
boolean
withGuiInformation
Return detailed information about requested service(s)
boolean
withPrice
Controls whether prices should be calculated. If customerNumber is supplied, the authenticated user requires the financial role with the provided customer
boolean
object
Required
List of consignments
array wrapped
object
AdditionalServices
Additional services to be added
array
AddressLine
The street name and number the consignment is to be delivered to
string
dangerousGoods
If dangerous goods are to be part of the consignment, the ADR-code(s) specifying the dangerous goods type(s) has to be provided
FromCountryCode
Required
Two-letter ISO-3166-1 country code of which consignment is sent from
string
FromPostalCode
Required
The postal code the consignment is sent from
string
id
Your internal reference to this consignment (you may calculate several consignment at the same time)
string attribute
Incoterms
International commercial terms
string
Packages
Required
List of all packages in the consignment
array
PickupPointId
The pickup point id to which the consignment is to be shipped to. Only relevant for parcel products
string
PickupPoints
List of pickup points for which estimated delivery time should be calculated for (if varue of 'WithEstimatedDeliveryTime' is true). If not provided, the default pickup point for the receiver's postal code will be used.
array
Products
Required
List of all services price and lead times should be calculated for
array
shippingDate
The date (and optionally time) the consignment will be shipped (used for computing estimated delivery date). NOTE: The lead time calculation interprets the provided date & time as the time when the consignment has been scanned at the terminal. If not provided, now() will be used
ToCity
The city the consignment is to be delivered to
string
ToCountryCode
Required
Two-letter ISO-3166-1 country code of which consignment is sent to
string
ToPostalCode
Required
The postal code the consignment is to be delivered to
string
EDI
Should the parcel be registered using EDI when shipped. Note that this flag may affect price and which services are available
boolean
Language
Language in which human-readable message should be returned.
string
Enum
NO
SE
SV
DA
EN
NumberOfAlternativeDeliveryDates
Number of alternative delivery dates to be suggested
integer <int32>
PostingAtPostoffice
Will the parcel be delivered at a post office when shipped
boolean
WithEnvironmentalData
Return environmental data about fossil free and electric transportation used on the shipments transport legs
boolean
WithEstimatedDeliveryTime
Extended lead time information, including predicted arrivar time at pickup point. Only supported for a limited set of services
boolean
WithExpectedDelivery
Controls whether lead times should be calculated or not
boolean
WithGuiInformation
Return detailed information about requested service(s)
boolean
WithPrice
Controls whether prices should be calculated. If customerNumber is supplied, the authenticated user requires the financial role with the provided customer
boolean

Responses

200 OK

Schema

consignments
List of consignments
array
uniqueId
Request unique id
string
object
Consignments
List of consignments
array
uniqueId
Request unique id
string attribute
400 Bad Request

Schema

fieldErrors
Required
array
object
FieldErrors
Required
array
429 Too Many Requests

Schema

Media type: text/plain

string
500 Internal Server Error

Schema

fieldErrors
Required
array
object
FieldErrors
Required
array

Request examples

{
  "consignments": [
    {
      "additionalServices": [],
      "fromCountryCode": "NO",
      "fromPostalCode": "1555",
      "id": "1",
      "packages": [
        {
          "grossWeight": 250,
          "id": "1",
          "nonStackable": false,
          "numberOfPallets": 0,
          "volumeSpecial": false
        }
      ],
      "pickupPoints": [],
      "products": [
        {
          "autoSelectCustomerNumber": false,
          "customerNumber": "123456789",
          "id": "5600"
        }
      ],
      "shippingDate": {
        "day": "15",
        "hour": "10",
        "minute": "36",
        "month": "11",
        "year": "2022"
      },
      "toCountryCode": "NO",
      "toPostalCode": "0173"
    }
  ],
  "edi": false,
  "language": "NO",
  "numberOfAlternativeDeliveryDates": 3,
  "postingAtPostoffice": false,
  "trace": false,
  "withEnvironmentalData": false,
  "withEstimatedDeliveryTime": false,
  "withExpectedDelivery": true,
  "withGuiInformation": true,
  "withPrice": true
}
<?xml version="1.0" encoding="UTF-8"?>
<ShippingGuideRequest>
  <Consignments>
    <Consignment id="1">
      <AdditionalServices>
      </AdditionalServices>
      <FromCountryCode>NO</FromCountryCode>
      <FromPostalCode>1555</FromPostalCode>
      <Packages>
        <Package id="1">
          <GrossWeight>250</GrossWeight>
        </Package>
      </Packages>
      <PickupPoints>
      </PickupPoints>
      <Products>
        <ProductIdType>
          <CustomerNumber>123456789</CustomerNumber>
          <Id>5600</Id>
        </ProductIdType>
      </Products>
      <ShippingDate>
        <Day>15</Day>
        <Hour>10</Hour>
        <Minute>36</Minute>
        <Month>11</Month>
        <Year>2022</Year>
      </ShippingDate>
      <ToCountryCode>NO</ToCountryCode>
      <ToPostalCode>0173</ToPostalCode>
    </Consignment>
  </Consignments>
  <Language>NO</Language>
  <NumberOfAlternativeDeliveryDates>3</NumberOfAlternativeDeliveryDates>
  <WithExpectedDelivery>true</WithExpectedDelivery>
  <WithGuiInformation>true</WithGuiInformation>
  <WithPrice>true</WithPrice>
</ShippingGuideRequest>

Response examples

{
  "consignments": [
    {
      "consignmentId": "1",
      "products": [
        {
          "expectedDelivery": {
            "alternativeDeliveryDates": [
              {
                "expectedDeliveryDate": {
                  "day": "16",
                  "month": "11",
                  "timeSlots": [
                    {
                      "endTime": {
                        "hour": "21",
                        "minute": "0"
                      },
                      "startTime": {
                        "hour": "17",
                        "minute": "0"
                      }
                    }
                  ],
                  "year": "2022"
                },
                "formattedExpectedDeliveryDate": "18.11.2022",
                "shippingDate": {
                  "day": "16",
                  "month": "11",
                  "year": "2022"
                },
                "workingDays": "1"
              },
              {
                "expectedDeliveryDate": {
                  "day": "16",
                  "month": "11",
                  "timeSlots": [
                    {
                      "endTime": {
                        "hour": "21",
                        "minute": "0"
                      },
                      "startTime": {
                        "hour": "17",
                        "minute": "0"
                      }
                    }
                  ],
                  "year": "2022"
                },
                "formattedExpectedDeliveryDate": "21.11.2022",
                "shippingDate": {
                  "day": "21",
                  "month": "11",
                  "year": "2022"
                },
                "workingDays": "1"
              },
              {
                "expectedDeliveryDate": {
                  "day": "22",
                  "month": "11",
                  "timeSlots": [
                    {
                      "endTime": {
                        "hour": "21",
                        "minute": "0"
                      },
                      "startTime": {
                        "hour": "17",
                        "minute": "0"
                      }
                    }
                  ],
                  "year": "2022"
                },
                "formattedExpectedDeliveryDate": "22.11.2022",
                "shippingDate": {
                  "day": "16",
                  "month": "11",
                  "year": "2022"
                },
                "workingDays": "1"
              }
            ],
            "earliestPickupDate": {
              "day": "16",
              "hour": "13",
              "minute": "23",
              "month": "11",
              "year": "2022"
            },
            "expectedDeliveryDate": {
              "day": "16",
              "month": "11",
              "timeSlots": [
                {
                  "endTime": {
                    "hour": "21",
                    "minute": "0"
                  },
                  "startTime": {
                    "hour": "17",
                    "minute": "0"
                  }
                }
              ],
              "year": "2022"
            },
            "formattedEarliestPickupDate": "16.11.2022 13:23",
            "formattedExpectedDeliveryDate": "18.11.2022",
            "userMessage": "",
            "workingDays": "1"
          },
          "id": "5600",
          "productionCode": "5600"
        }
      ]
    }
  ],
  "uniqueId": "66091c94-6565-4c42-9c49-34bab012236d"
}
comments powered by Disqus