Skip to main content

API updates

Subscribe

Get updates via email or subscribe to our RSS feed.

Privacy policy

You can unsubscribe at any time by clicking the link in the footer of our emails. Read more about our privacy policy.

We use Mailchimp. By clicking below to subscribe, you acknowledge that your information will be transferred to Mailchimp for processing. Learn more about Mailchimp's privacy practices here.

Important API changes

Booking API

For services 4850 and 5000, pickup point type 37 (locker/pakkeboks) cannot be requested.

ShippingGuide API

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

PickupPoint API

Pakkeboks pickup points (unit type: 37) in Norway now shows photos of the location. This can be used to assist the end user to find the placement of the pakkeboks at the address.

Booking API

Important: We’ll soon stop supporting API access on the https://www.mybring.com/booking/api base URL. Please use https://api.bring.com/booking/api instead, if you aren’t already.

Shipping Guide API

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"
Older updates

Tracking API

The event statuses ARRIVED_COLLECTION and ARRIVED_DELIVERY are not valid anymore, and therefore have been removed from the Tracking API.

Tracking API

Starting 1 August 2022, Tracking API version v1 will be deprecated and the requests will be automatically forwarded to the latest version, v2. It is not a breaking change. In the new version you will have access to many more fields.

Shipping Guide API

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.

Reports API

PIP services are now visible in Mybring Delivery quality report for Parcel Norway domestic.

Reports API

New report Complete status including freight cost for Parcel Norway domestic added to Mybring.

Invoice and Reports API

Invoice and reports API will use main customer number to get invoice and reports data for parcel international customers.

Address API

Address API now supports post office box address queries and validation

Postal code and Shipping guide APIs

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

Tracking API

As an increased security measure, we have hidden the pickup code from the open Tracking API. The logged in Tracking API will still contain the pickup code.

ShippingGuide API

Courier bicycle services are currently not supported in Norway.

Booking API

The tracking link in the response from booking API is changed from http to https.

Shipping Guide API

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

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.
Read more about the upcoming DNS change

Tracking API

The Tracking API now includes the details of the expected pickup point, where an item is expected to arrive. It contains expected pickup-point-unit id, name and URL(a link to detailed information of pickup point like location, opening hours, etc).

Shipping Guide API

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

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

Booking API

When booking parcel services from Finland, weight and dimensions are mandatory to set in the request.

PickupPoint API

Driving time to returned pickup points is now available in response

ShippingGuide API

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

ShippingGuide API

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)

Booking API

It is now possible to book Nordic parcels with Limited Quantities (0003) additional service

Booking API

When booking BUSINESS_PARCEL or PICKUP_PARCEL export from Norway, it is now possible to pass an IOSS number as an iossNumber element.

Postal Code API

Icelandic postal codes are now supported

Shipping guide API

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

Booking API

When booking BUSINESS_PARCEL or PICKUP_PARCEL export from Norway, the customs declaration field CountryOfOrigin is now mandatory. In addition, the recipient email address or phone number has to be provided.

Postal Code API

Exposed two new endpoints for listing all available postal codes for supported countries.

Shipping Guide API

Version 1.0 was decommissioned.

Shipping Guide API

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

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

Pickup Point API

The Pickup Point API now provides max parcel dimensions for Pakkeboks (parcel lockers in Norway).

Tracking API

The Tracking API now includes estimated arrival time window of delivery for supported shipments.

Pickup Point API

The Pickup Point API requires authentication for all.

Shipping Guide API

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

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

Booking API, Shipping Guide API

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.

Event Cast API

Updated maximum length limit for header, also added the maximum length information for id, authenticator, content type and URL.

Shipping Guide API

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

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

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

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

Booking API

Added support for booking parcel services without measurements.

Event Cast API

Added support for new request parameter limit. This can be used to limit the number of latest webhooks returned.

Shipping Guide API

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

Shipping Guide API

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.

Reports API

Updated Reports API with APIs used to get reports overview statistics and count of shipments by key events.

Mailbox Packet API

Decommissioned the API. Mailbox parcel services must be booked via the Booking API from the same date.

Booking API

Added support for sending booking confirmation e-mail if e-mail is specified in request. Can be applied to sender’s e-mail for outgoing services, and both sender’s/recipient’s e-mail for return services. Note that e-mail is optional and can at any time be skipped from the request.

Reports API

Added InvoiceSource in metadata section of the response when specified invoice report is generated.

Booking API, Shipping Guide API

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

Shipping Guide API

Decommissioned Home Delivery Mailbox from Shipping Guide API.

Event Cast API

Released Event Cast API, an API for getting event updates pushed instead of polling tracking.

Shipping Guide API

Decommissioned Småpakker from Shipping Guide API.

Invoice API

Added new attributes fromDate and toDate to specify period for fetching invoices.

Shipping Guide API

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

Shipping Guide API

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

Booking API

It is now possible to pass customs declaration information that will be sent electronically to the destination country, using the field ediCustomsDeclarations.

Mailbox Packet API, Shipping Guide API

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

Booking API

Added new syntax for requesting pickup. Both ways are still supported, but they can’t be combined.

Warehousing API

Added new attribute OrderItem/ArticleMonetaryAmounts that contains the article unit sales price.

Booking API

Added new syntax for requesting additional services. Both ways are still supported, but they can’t be combined.

Shipping Guide API

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

Modify Delivery API

Released Modify Delivery API, an API used to modify a shipment currently on its way.

Shipping Guide API

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

Shipping Guide API

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

Shipping Guide API

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

Warehousing API

The Order Management API split out of the Warehousing API. These will now continue as two separate APIs.