Skip to main content

Shipping Guide API

Updates

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

21 January 2026 Important

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 2025 Important

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

Shipping Guide API - Return mailbox parcel (9650) decommissioning

25 August 2025 Important

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.

Older updates

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 - 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

Shipping Guide API - Deprecation of SOAP endpoint

21 June 2023

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 Shipping Guide API, you have until 1 March 2024 to migrate to the JSON/XML over HTTP based endpoints.

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

ShippingGuide API

15 May 2023

Going forward Shippinguide API will support leadtime, prices, servicetext for service 5300 & 5400 to and from svalbard.

More details can be found here Svabard Shipments

ShippingGuide API

17 April 2023

Going forward Shippinguide API will support leadtime, prices, servicetext for service 5100 to and from svalbard.

More details can be found here Svabard Shipments

ShippingGuide API

20 March 2023

Going forward Leadtimes will vary depending on whether you have a pickup agreement with Bring.

More details on how pickup agreement affects your leadtime can be found here Leadtime

Note! Removal of temporary domain api-new.bring.com

11 January 2023General

From 19 January 2023, APIs hosted on api-new.bring.com will stop working. Please start using api.bring.com instead of api-new.bring.com.

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

ShippingGuide API

4 October 2022

The Same day delivery VAS (2012) allows shipments to be delivered same or next-day, depending on when the shipment is booked. By default, SG API returns the full service coverage area for Same day delivery.

The “sortingAreas” tag allows the web shop to reduce the delivery area to the area they currently choose to provide the service.

The “routeInformation” tag ontains information about the sorting area for a specific parcel. Intended use is to aid pre-sorting of same day parcels.

For more information read https://developer.bring.com/api/shipping-guide_2/#sorting-area-for-same-day-delivery-2012

Shipping Guide API

30 June 2022

Lead time does not only depend on the recipient’s postal code, but also the address itself.

For example, two different addresses on the same postal code can have different lead time. We have therefore added an addressLine field, which allows lead time to be calculated based on both postal code and street address. For this to work, it is important that recipients fill out a valid street address.

By using our Address API, the address the recipients fill inn can be pre-validated, which will ensure more accurate lead times.We therefore recommend using the Address API in combination with Shipping Guide API.

There are several services that are affected by this new field: 1000, 1988, 3500, 5000, 1736, 5600, 0330, 0332, 0349, 3570, 3584

<ns:AddressLine>Testsvingen 12</ns:AddressLine>
      "addressLine":"Testsvingen 12"

Shipping Guide API

21 June 2022

For customers requesting environmental data in Shipping Guide API, a link to an environmental logo that can be used in checkout is now being returned in the guiInformation part of the response. Note that the WithGuiInformation field must therefore be set to true. The environmental data description text has also been extended to cover 5800 Pakke til hentested and 0340 Pickup Parcel/0342 Pickup Parcel Bulk when sent to Norway.

Postal code and Shipping guide APIs

16 February 2022

Country code SJ (Svalbard and Jan Mayen) has been added to the list of supported country codes

ShippingGuide API

25 January 2022

Courier bicycle services are currently not supported in Norway.

Shipping Guide API

5 January 2022

For estimated arrival times for Norwegian parcels going to pickup points, it is now possible to get arrival date specific arrival times at pickup point when requesting alternate delivery days. The number of expected working days is also returned. For arrival times at pickup points, the ExpectedDelivery response element normally used for lead time information is not returned. In stead a list of EstimatedDeliveryTimes is available.

Read more about estimated arrival times here

Upcoming DNS change 1st of April 2022

21 December 2021General

Bring’s applications and infrastructure are going through bigger changes, as part of modernizing our infrastructure. One of these changes, is update of our load balancing component, and that will affect services running on api.bring.com. Be sure to verify your integration before the change to ensure no service disruption.

Shipping Guide API

6 December 2021

Environmental data including electric and fossil free transportation used during last mile transport leg, is now available for selected Norwegian domestic and Nordic parcel services.

ShippingGuide API

30 November 2021

Posten/Bring logo URL is now returned when WithGuiInformation is requested.

ShippingGuide API

9 November 2021

Total number of zones used as basis for returned price, is now available for revised groupage and Norwegian domestic parcel services

ShippingGuide API

26 October 2021

When requesting 5600 or PÅ_DOREN, the requested shipping date cannot be more than 10 days away if alternate delivery days are requested (via numberOfAlternativeDeliveryDates)

Shipping guide API

30 August 2021

The Shipping guide API now includes estimated arrival time window of delivery for selected domestic Norway cargo services.

Shipping Guide API

1 July 2021

Version 1.0 was decommissioned.

Shipping Guide API

29 June 2021

For 5800 Pakke til hentested and Servicepakke, leadtime responses (i.e requests with WithExpectedDelivery flag set to true) are now returning an expected delivery date based on historical data (ETA) instead of static calculations.

EDI documentation

8 June 2021General

New versions of the documents Appendix2 Available Services and Appendix 2A Instructions for service Implementation

Shipping Guide API

15 February 2021

Extended leadtime information is available for Bedriftspakke (BPAKKE_DOR-DOR) and Pakke til bedrift (5000). Both services will now include the shipment’s estimated arrival time in addition to date.

Shipping Guide API

11 February 2021

For Norwegian parcel services, unique alternative delivery dates can now be requested.

Booking API, Shipping Guide API

9 December 2020

For Pickup Parcel (0340) and Pickup Parcel Bulk (0342) sent to Sweden and Denmark, Flex Delivery (0041) is no longer applicable as an additional service.

Booking API, Shipping Guide API

9 December 2020

For Pickup Parcel (0340) and Pickup Parcel Bulk (0342) sent to Sweden and Denmark, Flex Delivery (0041) is no longer applicable as an additional service.

Shipping Guide API

1 October 2020

INDOOR_LIGHT will be decomissioned from schema 11 and 12. Customers requesting this service in our Shipping Guide API must instead use 3332 as ID (note: only available in our latest version - schema 12)

Shipping Guide API

11 September 2020

Added support to get estimated arrival time for requested pickup points in Shipping Guide API. On request of these new parameters (for REST API- estimateddeliverytime, pickuppoints and for SOAP V2- WithEstimatedDeliveryTime, PickupPoints), response will contain ’estimatedDeliveryTimes’, representing the estimated time of a parcel`s arrival at the respective pickup point(s).

Shipping Guide API

26 August 2020

Added support for Green Delivery as a new tag in Shipping Guide response. Customers requesting Home Delivery services in our Shipping Guide API will get to know whether delivery to a specific postal code is green/fossil free or not.

Booking API, Shipping Guide API

5 August 2020

Added mandatory weight validation for cargo norway bookings along with mandatory atleast one of Volume, Load meters, Dimensions, Pallets

Booking API, Shipping Guide API

5 August 2020

Added mandatory weight validation for cargo norway bookings along with mandatory atleast one of Volume, Load meters, Dimensions, Pallets

Shipping Guide API

1 June 2020

Decomissioned version 8 of the Shipping Guide API. Customers should use Shipping Guide API 2.0 instead.

Shipping Guide API

5 May 2020

Added support for new request parameter addressLine. Lead times for Bedriftspakke, 5000, På døren and 5600 will be calculated based on postal code + street address from July 07 2020.

Booking API, Shipping Guide API

3 December 2019

Decommissioned Courier 6H for Norway from Booking API and Shipping Guide API.

Booking API, Shipping Guide API

3 December 2019

Decommissioned Courier 6H for Norway from Booking API and Shipping Guide API.

Shipping Guide API

31 October 2019

Decommissioned Home Delivery Mailbox from Shipping Guide API.

Shipping Guide API

21 August 2019

Decommissioned Småpakker from Shipping Guide API.

Shipping Guide API

22 March 2019

Decommissioned version 9 of the Shipping Guide API. Customers should use Shipping Guide API 2.0 instead.

Shipping Guide API

15 March 2019

Decommissioned version 7 of the Shipping Guide API. Customers should use Shipping Guide API 2.0 instead.

Mailbox Packet API, Shipping Guide API

31 January 2019

Added support for bagOnDoor, a delivery alternative for parcels that cannot be delivered to the mailbox.

Shipping Guide API

20 November 2018

Decommissioned version 1 and 2 of the Shipping Guide API. Customers should use Shipping Guide API 2.0 instead.

Shipping Guide API

9 April 2018

Decommissioned version 10 of the Shipping Guide API. Customers should use Shipping Guide API 2.0 instead.

Shipping Guide API

28 March 2018

Decommissioned version 3 of the Shipping Guide API. Customers should use Shipping Guide API 2.0 instead.

Shipping Guide API

26 March 2018

Decommissioned version 4, 5 and 6 of the Shipping Guide API. Customers should use Shipping Guide API 2.0 instead.

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
https://api.bring.com/shippingguide
Usage Method Endpoint
Fetch shipping details POST /api/v2/products

Fetch shipping details

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

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