Bring

developer

Tracking API

Introduction

The Tracking API provides the opportunity to track shipments by reference, package or shipment number. It is an easy way to display details and the status of shipments. The information available in this API is the same that is publically available from the Tracking web site.

Formats

The Tracking API generates the following formats:

  • XML
  • JSON
  • JSONP

Versioning

Latest Tracking API version: v2

We encourage you to use the latest version of our API all time. Of course, we keep the previous version for some time so that you will get enough time to convert your application. This API supports versioning by two means.

  • Select version by request-header Use the normal URL but add the following request-header:

    Header Example
    api-version 2

    Example request curl -H "api-version: 2" https://tracking.bring.com/api/tracking.json?q=TESTPACKAGE-AT-PICKUPPOINT

  • Select version by URL Use the normal URL, but add {v1, v2} to the URL. Example:

    Application URL example
    Open tracking https://tracking.bring.com/api/v2/tracking.json?q=TESTPACKAGE-AT-PICKUPPOINT
    Logged-in tracking https://mybring.com/tracking/api/v2/tracking.json?q=TESTPACKAGE-AT-PICKUPPOINT

    You can verify that your request were used correctly by certifying that the response contains an element based on the request type:

    URI request Response type Example
    tracking.json application/json; charset=utf-8 {"apiVersion": "2"}
    tracking.xml application/xml;charset=utf-8 <ApiVersion>2</ApiVersion>

    Example request curl -v https://tracking.bring.com/api/v2/tracking.json?q=TESTPACKAGE-AT-PICKUPPOINT

Authentication

If you are a Mybring user, you can authenticate requests to the Tracking API. Authenticated requests have the following benefits:

  • More information about parcels:
    • Prices
    • Name
    • Address
    • Signatures for proof of develiery
  • Less strict rate limiting

See the getting started guide on authentication if you’re not sure what this means.

Header Example Comment
X-MyBring-API-Uid john.doe@example.com Mybring login ID
X-MyBring-API-Key 1234abc-abcd-1234-5678-abcd1234abcd Mybring login’s API key
X-Bring-Client-URL https://example.com/ A URL that sort of identifies where you’re using the APIs.

Those headers must be present for authenticating requests, and you have to use the endpoint

https://www.mybring.com/tracking/api/

JSON API

We follow the JSON API specification with one exception: we allow media type to be specified as application/json instead of application/vnd.api+json.

Overview of endpoints

Base URL

https://tracking.bring.com/api
Method Endpoint Usage
GET /{version}/tracking{mediaTypeExtension} Get information about a shipment

Tracking endpoint

Get information about an existing shipment based on a tracking number, shipment number or reference.

URL

https://tracking.bring.com/api/{version}/tracking.json
https://tracking.bring.com/api/{version}/tracking.xml

Request params

URI parameter Type Description
version string

Required. v1 is deprecated and will be removed soon. Use v2 when requesting the tracking API

Possible values
  • v1
  • v2
Header name Type Description
X-MyBring-API-Uid string

Required. Your Mybring login ID
X-MyBring-API-Key string

Required. Your user’s API key
X-Bring-Client-URL string

Required. A URL that sort of identifies where you’re using the APIs.
Query param Type Description
q string

Required. Reference, package number, shipment number to search for


Example: TESTPACKAGE-AT-PICKUPPOINT, 370000000000000001
aktornummer string

Optional. Represents a valid customer number registered with Posten


Example: 12345678901
callback string

Optional. JSONP callback function name

Responses

HTTP status code 200

For testing you can use “TESTPACKAGE-AT-PICKUPPOINT” as the tracking number to generate test results. For real tracking this must be a valid number.

You can find an XSD for the XML response here: tracking-v2.xsd.

A parcel has a number of events connected to it during its travel. Here are a list of current event statuses that can be returned.

Event Description
ARRIVED_DELIVERY Arrived Delivery point - This is when a container arrives at recipients address, and can start unloading.

ARRIVED_COLLECTION Arrived for collection at pickup point
ATTEMPTED_DELIVERY The package has been attempted delivered at the door. Depending on the service it will be tried again or sent to closest pickup point.
CUSTOMS Package is in customs clearance.
COLLECTED The parcel has been collected at pickup address.
DELIVERED Package has been delivered.
DELIVERED_SENDER Package has been returned to the sender
DELIVERY_CANCELLED Home delivery has been canceled by the customer.
DELIVERY_CHANGED Date for Home delivery has been changed by customer.
DELIVERY_ORDERED Home delivery has been ordered
DEVIATION Deviation in production. Something wrong has happened and there is a probability for delay.
HANDED_IN Package has been handed in to Bring.
INTERNATIONAL Package has been sent from origin country or arrived at destination country.

IN_TRANSIT Package is in transit.
NOTIFICATION_SENT Notification for this package has been sent by sms, push and/or mail. This can be informational notifications and action notification like pickup notice.
PRE_NOTIFIED EDI message for the package has been received by Bring.
READY_FOR_PICKUP Package has arrived at pickup point.
RETURN The package has been returned to sender.

TRANSPORT_TO_RECIPIENT Package has been loaded for delivery to the recipient.
TERMINAL The package is now registered/arrived at inbound/outbound storage terminal
UNKNOWN Represents unknown / undefined events

Media Type: application/json

Field Type Description
consignmentSet object

Required.
  consignmentId string

Required.
  previousConsignmentId string

Optional.
  packageSet array

Required.
    statusDescription string

Required.
    descriptions array

Optional.
    packageNumber string

Required.
    previousPackageNumber string

Required.
    productName string

Required.
    productCode string

Required.
    productLink string

Required.
    brand string

Required.
    lengthInCm number

Required.
    widthInCm number

Required.
    heightInCm number

Required.
    volumeInDm3 number

Required.
    weightInKgs number

Required.
    pickupCode string

Required.
    dateOfReturn string

Required.
    senderName string

Required.
    senderAddress object

Required.
      addressLine1 string

Optional.
      addressLine2 string

Optional.
      postalCode string

Optional.
      city string

Optional.
      countryCode string

Optional.
      country string

Optional.
    recipientAddress object

Required.
      addressLine1 string

Optional.
      addressLine2 string

Optional.
      postalCode string

Optional.
      city string

Optional.
      countryCode string

Optional.
      country string

Optional.
    recipientHandlingAddress object

Required.
      addressLine1 string

Optional.
      addressLine2 string

Optional.
      postalCode string

Optional.
      city string

Optional.
      countryCode string

Optional.
      country string

Optional.
    eventSet array

Required.
      description string

Required.
      status string

Required.
      recipientSignature object

Required.
        name string

Optional.
      unitId string

Required.
      unitType string

Required.
      postalCode string

Optional.
      city string

Optional.
      countryCode string

Optional.
      country string

Optional.
      dateIso string

Required.
      displayDate string

Required.
      displayTime string

Required.
      consignmentEvent boolean

Required.
      insignificant boolean

Required.
      additionalServiceSet array

Optional.
      recipientAddress object

Required.
        addressLine1 string

Optional.
        addressLine2 string

Optional.
        postalCode string

Optional.
        city string

Optional.
        countryCode string

Optional.
        country string

Optional.
      recipientHandlingAddress object

Required.
        addressLine1 string

Optional.
        addressLine2 string

Optional.
        postalCode string

Optional.
        city string

Optional.
        countryCode string

Optional.
        country string

Optional.
      senderReference string

Required.
      senderCustomerNumber string

Required.
      senderCustomerMasterNumber string

Required.
      senderName string

Required.
      senderAddress object

Required.
        addressLine1 string

Optional.
        addressLine2 string

Optional.
        postalCode string

Optional.
        city string

Optional.
        countryCode string

Optional.
        country string

Optional.
      senderCustomerType string

Required.
      recipientCustomerNumber string

Required.
      recipientCustomerMasterNumber string

Required.
      recipientCustomerType string

Required.
      isPickupNoticeAvailable boolean

Required.
      consignmentActionSet object

Required.
        actionType string

Required.
        actionURL string

Required.
      totalWeightInKgs number

Required.
      totalVolumeInDm3 number

Required.
apiVersion object

Required.

The example below shows an successful deliverance of a package at a pickup point

{
  "apiVersion": "2",
  "consignmentSet": [
    {
      "consignmentId": "SHIPMENTNUMBER",
      "previousConsignmentId": "",
      "packageSet": [
        {
          "statusDescription": "Package can be collected at pickup point.",
          "descriptions": [],
          "packageNumber": "TESTPACKAGEATPICKUPPOINT",
          "previousPackageNumber": "",
          "productName": "CARBON-NEUTRAL SERVICE PARCEL",
          "productCode": "1202",
          "productLink": "http://www.bring.no/english/shortcuts/1202",
          "brand": "POSTEN",
          "lengthInCm": 41,
          "widthInCm": 38,
          "heightInCm": 29,
          "volumeInDm3": 45.2,
          "weightInKgs": 16.5,
          "pickupCode": "AA11",
          "dateOfReturn": "01.12.2011",
          "senderName": "POSTEN NORGE AS",
          "senderAddress": {
            "addressLine1": "",
            "addressLine2": "",
            "postalCode": "",
            "city": "",
            "countryCode": "",
            "country": ""
          },
          "recipientHandlingAddress": {
            "addressLine1": "",
            "addressLine2": "",
            "postalCode": "1407",
            "city": "VINTERBRO",
            "countryCode": "",
            "country": ""
          },
          "eventSet": [
            {
              "description": "The shipment has arrived at pickup point.",
              "status": "READY_FOR_PICKUP",
              "recipientSignature": {
                "name": ""
              },
              "unitId": "122608",
              "unitInformationUrl": "https://api.bring.com/pickuppoint/api/pickuppoint/NO/id/122608.xml",
              "unitType": "BRING",
              "postalCode": "2341",
              "city": "LØTEN",
              "countryCode": "NO",
              "country": "Norway",
              "dateIso": "2010-10-01T08:30:25+02:00",
              "displayDate": "01.10.2010",
              "displayTime": "08:30",
              "consignmentEvent": false,
              "insignificant": false
            },
            {
              "description": "The shipment has been handed in at terminal and forwarded.",
              "status": "IN_TRANSIT",
              "recipientSignature": {
                "name": ""
              },
              "unitId": "032850",
              "unitType": "BRING",
              "postalCode": "0024",
              "city": "OSLO",
              "countryCode": "NO",
              "country": "Norway",
              "dateIso": "2010-09-30T08:27:08+02:00",
              "displayDate": "30.09.2010",
              "displayTime": "08:27",
              "consignmentEvent": false,
              "insignificant": false
            }
          ],
          "additionalServiceSet": []
        }
      ],
      "recipientHandlingAddress": {
        "addressLine1": "",
        "addressLine2": "",
        "postalCode": "1407",
        "city": "VINTERBRO",
        "countryCode": "",
        "country": ""
      },
      "senderReference": "",
      "senderCustomerNumber": "",
      "senderCustomerMasterNumber": "",
      "senderName": "POSTEN NORGE AS",
      "senderAddress": {
        "addressLine1": "",
        "addressLine2": "",
        "postalCode": "",
        "city": "",
        "countryCode": "",
        "country": ""
      },
      "senderCustomerType": "",
      "recipientCustomerNumber": "",
      "recipientCustomerMasterNumber": "",
      "recipientCustomerType": "",
      "isPickupNoticeAvailable": false,
      "totalWeightInKgs": 16.5,
      "totalVolumeInDm3": 45.2
    }
  ]
}

Returned upon no search responses being returned for the request itself

{
  "apiVersion": "2",
  "consignmentSet": [
    {
      "error": {
        "code": 404,
        "message": "No shipments found"
      }
    }
  ]
}

The example below is showing a package that have been EDI notified, but is not received by Bring.

{
  "apiVersion": "2",
  "consignmentSet": [
    {
      "consignmentId": "SHIPMENTNUMBER",
      "previousConsignmentId": "",
      "packageSet": [
        {
          "statusDescription": "Norway Post/Bring has received a message from sender that a package is on its way, but has not yet received the package. In case of questions, please contact the sender",
          "descriptions": [],
          "packageNumber": "TESTPACKAGEEDI",
          "previousPackageNumber": "",
          "productName": "HOME DELIVERY",
          "productCode": "1736",
          "productLink": "http://www.bring.no/english/shortcuts/1736",
          "brand": "POSTEN",
          "lengthInCm": 41,
          "widthInCm": 38,
          "heightInCm": 29,
          "volumeInDm3": 45.2,
          "weightInKgs": 16.5,
          "eventSet": [
            {
              "description": "No shipment has been received yet, only notification of the shipment.",
              "status": "PRE_NOTIFIED",
              "recipientSignature": {
                "name": ""
              },
              "unitId": "904030",
              "unitType": "BRING",
              "postalCode": "",
              "city": "",
              "countryCode": "",
              "country": "",
              "dateIso": "2018-05-24T12:44:12+02:00",
              "displayDate": "24.05.2018",
              "displayTime": "12:44",
              "consignmentEvent": false,
              "insignificant": false
            }
          ],
          "additionalServiceSet": []
        }
      ],
      "senderReference": "",
      "senderCustomerNumber": "",
      "senderCustomerMasterNumber": "",
      "senderCustomerType": "",
      "recipientCustomerNumber": "",
      "recipientCustomerMasterNumber": "",
      "recipientCustomerType": "",
      "isPickupNoticeAvailable": false,
      "totalWeightInKgs": 16.5,
      "totalVolumeInDm3": 45.2
    }
  ]
}

The example below is showing a package waiting for the recipient to collect it at a pickup point

{
  "apiVersion": "2",
  "consignmentSet": [
    {
      "consignmentId": "SHIPMENTNUMBER",
      "previousConsignmentId": "",
      "packageSet": [
        {
          "statusDescription": "Package can be collected at pickup point.",
          "descriptions": [],
          "packageNumber": "TESTPACKAGEATPICKUPPOINT",
          "previousPackageNumber": "",
          "productName": "CARBON-NEUTRAL SERVICE PARCEL",
          "productCode": "1202",
          "productLink": "http://www.bring.no/english/shortcuts/1202",
          "brand": "POSTEN",
          "lengthInCm": 41,
          "widthInCm": 38,
          "heightInCm": 29,
          "volumeInDm3": 45.2,
          "weightInKgs": 16.5,
          "pickupCode": "AA11",
          "dateOfReturn": "01.12.2011",
          "senderName": "POSTEN NORGE AS",
          "senderAddress": {
            "addressLine1": "",
            "addressLine2": "",
            "postalCode": "",
            "city": "",
            "countryCode": "",
            "country": ""
          },
          "recipientHandlingAddress": {
            "addressLine1": "",
            "addressLine2": "",
            "postalCode": "1407",
            "city": "VINTERBRO",
            "countryCode": "",
            "country": ""
          },
          "eventSet": [
            {
              "description": "The shipment has arrived at pickup point.",
              "status": "READY_FOR_PICKUP",
              "recipientSignature": {
                "name": ""
              },
              "unitId": "122608",
              "unitInformationUrl": "https://api.bring.com/pickuppoint/api/pickuppoint/NO/id/122608.xml",
              "unitType": "BRING",
              "postalCode": "2341",
              "city": "LØTEN",
              "countryCode": "NO",
              "country": "Norway",
              "dateIso": "2010-10-01T08:30:25+02:00",
              "displayDate": "01.10.2010",
              "displayTime": "08:30",
              "consignmentEvent": false,
              "insignificant": false
            },
            {
              "description": "The shipment has been handed in at terminal and forwarded.",
              "status": "IN_TRANSIT",
              "recipientSignature": {
                "name": ""
              },
              "unitId": "032850",
              "unitType": "BRING",
              "postalCode": "0024",
              "city": "OSLO",
              "countryCode": "NO",
              "country": "Norway",
              "dateIso": "2010-09-30T08:27:08+02:00",
              "displayDate": "30.09.2010",
              "displayTime": "08:27",
              "consignmentEvent": false,
              "insignificant": false
            }
          ],
          "additionalServiceSet": []
        }
      ],
      "recipientHandlingAddress": {
        "addressLine1": "",
        "addressLine2": "",
        "postalCode": "1407",
        "city": "VINTERBRO",
        "countryCode": "",
        "country": ""
      },
      "senderReference": "",
      "senderCustomerNumber": "",
      "senderCustomerMasterNumber": "",
      "senderName": "POSTEN NORGE AS",
      "senderAddress": {
        "addressLine1": "",
        "addressLine2": "",
        "postalCode": "",
        "city": "",
        "countryCode": "",
        "country": ""
      },
      "senderCustomerType": "",
      "recipientCustomerNumber": "",
      "recipientCustomerMasterNumber": "",
      "recipientCustomerType": "",
      "isPickupNoticeAvailable": false,
      "totalWeightInKgs": 16.5,
      "totalVolumeInDm3": 45.2
    }
  ]
}

The example below is showing a package that has been loaded on a distribution car for delivery to the reciepient.

{
  "apiVersion": "2",
  "consignmentSet": [
    {
      "consignmentId": "SHIPMENTNUMBER",
      "previousConsignmentId": "",
      "packageSet": [
        {
          "statusDescription": "Package will be delivered to recipient this evening between 1700 and 2100. The driver will call 30 - 60 minutes before delivery",
          "descriptions": [],
          "packageNumber": "TESTPACKAGELOADEDFORDELIVERY",
          "previousPackageNumber": "",
          "productName": "HOME DELIVERY",
          "productCode": "1736",
          "productLink": "http://www.bring.no/english/shortcuts/1736",
          "brand": "POSTEN",
          "lengthInCm": 41,
          "widthInCm": 38,
          "heightInCm": 29,
          "volumeInDm3": 45.2,
          "weightInKgs": 16.5,
          "eventSet": [
            {
              "description": "The shipment has been loaded for delivery.",
              "status": "TRANSPORT_TO_RECIPIENT",
              "recipientSignature": {
                "name": ""
              },
              "unitId": "971190",
              "unitType": "BRING",
              "postalCode": "0001",
              "city": "OSLO",
              "countryCode": "NO",
              "country": "Norway",
              "dateIso": "2010-09-30T16:48:57+02:00",
              "displayDate": "30.09.2010",
              "displayTime": "16:48",
              "consignmentEvent": false,
              "insignificant": false
            },
            {
              "description": "The shipment has been handed in at terminal and forwarded.",
              "status": "IN_TRANSIT",
              "recipientSignature": {
                "name": ""
              },
              "unitId": "032850",
              "unitType": "BRING",
              "postalCode": "0024",
              "city": "OSLO",
              "countryCode": "NO",
              "country": "Norway",
              "dateIso": "2010-09-30T08:27:08+02:00",
              "displayDate": "30.09.2010",
              "displayTime": "08:27",
              "consignmentEvent": false,
              "insignificant": false
            }
          ],
          "additionalServiceSet": []
        }
      ],
      "senderReference": "",
      "senderCustomerNumber": "",
      "senderCustomerMasterNumber": "",
      "senderCustomerType": "",
      "recipientCustomerNumber": "",
      "recipientCustomerMasterNumber": "",
      "recipientCustomerType": "",
      "isPickupNoticeAvailable": false,
      "totalWeightInKgs": 16.5,
      "totalVolumeInDm3": 45.2
    }
  ]
}

The example below is showing a package that has been delivered to the reciepient.

{
  "apiVersion": "2",
  "consignmentSet": [
    {
      "consignmentId": "SHIPMENTNUMBER",
      "previousConsignmentId": "",
      "packageSet": [
        {
          "statusDescription": "",
          "descriptions": [],
          "packageNumber": "TESTPACKAGEDELIVERED",
          "previousPackageNumber": "",
          "productName": "HOME DELIVERY",
          "productCode": "1736",
          "productLink": "http://www.bring.no/english/shortcuts/1736",
          "brand": "POSTEN",
          "lengthInCm": 41,
          "widthInCm": 38,
          "heightInCm": 29,
          "volumeInDm3": 45.2,
          "weightInKgs": 16.5,
          "eventSet": [
            {
              "description": "The shipment has been delivered.",
              "status": "DELIVERED",
              "recipientSignature": {
                "name": "O Nordmann"
              },
              "unitId": "971190",
              "unitType": "BRING",
              "postalCode": "",
              "city": "",
              "countryCode": "",
              "country": "",
              "dateIso": "2010-09-30T17:45:25+02:00",
              "displayDate": "30.09.2010",
              "displayTime": "17:45",
              "consignmentEvent": false,
              "insignificant": false
            },
            {
              "description": "The shipment has been loaded for delivery.",
              "status": "TRANSPORT_TO_RECIPIENT",
              "recipientSignature": {
                "name": ""
              },
              "unitId": "971190",
              "unitType": "BRING",
              "postalCode": "0001",
              "city": "OSLO",
              "countryCode": "NO",
              "country": "Norway",
              "dateIso": "2010-09-30T16:48:57+02:00",
              "displayDate": "30.09.2010",
              "displayTime": "16:48",
              "consignmentEvent": false,
              "insignificant": false
            },
            {
              "description": "The shipment has been handed in at terminal and forwarded.",
              "status": "IN_TRANSIT",
              "recipientSignature": {
                "name": ""
              },
              "unitId": "032850",
              "unitType": "BRING",
              "postalCode": "0024",
              "city": "OSLO",
              "countryCode": "NO",
              "country": "Norway",
              "dateIso": "2010-09-30T08:27:08+02:00",
              "displayDate": "30.09.2010",
              "displayTime": "08:27",
              "consignmentEvent": false,
              "insignificant": false
            }
          ],
          "additionalServiceSet": []
        }
      ],
      "senderReference": "",
      "senderCustomerNumber": "",
      "senderCustomerMasterNumber": "",
      "senderCustomerType": "",
      "recipientCustomerNumber": "",
      "recipientCustomerMasterNumber": "",
      "recipientCustomerType": "",
      "isPickupNoticeAvailable": false,
      "totalWeightInKgs": 16.5,
      "totalVolumeInDm3": 45.2
    }
  ]
}

Media Type: application/xml

Field Type Description
consignmentSet object

Required.
  consignmentId string

Required.
  previousConsignmentId string

Optional.
  packageSet array

Required.
    statusDescription string

Required.
    descriptions array

Optional.
    packageNumber string

Required.
    previousPackageNumber string

Required.
    productName string

Required.
    productCode string

Required.
    productLink string

Required.
    brand string

Required.
    lengthInCm number

Required.
    widthInCm number

Required.
    heightInCm number

Required.
    volumeInDm3 number

Required.
    weightInKgs number

Required.
    pickupCode string

Required.
    dateOfReturn string

Required.
    senderName string

Required.
    senderAddress object

Required.
      addressLine1 string

Optional.
      addressLine2 string

Optional.
      postalCode string

Optional.
      city string

Optional.
      countryCode string

Optional.
      country string

Optional.
    recipientAddress object

Required.
      addressLine1 string

Optional.
      addressLine2 string

Optional.
      postalCode string

Optional.
      city string

Optional.
      countryCode string

Optional.
      country string

Optional.
    recipientHandlingAddress object

Required.
      addressLine1 string

Optional.
      addressLine2 string

Optional.
      postalCode string

Optional.
      city string

Optional.
      countryCode string

Optional.
      country string

Optional.
    eventSet array

Required.
      description string

Required.
      status string

Required.
      recipientSignature object

Required.
        name string

Optional.
      unitId string

Required.
      unitType string

Required.
      postalCode string

Optional.
      city string

Optional.
      countryCode string

Optional.
      country string

Optional.
      dateIso string

Required.
      displayDate string

Required.
      displayTime string

Required.
      consignmentEvent boolean

Required.
      insignificant boolean

Required.
      additionalServiceSet array

Optional.
      recipientAddress object

Required.
        addressLine1 string

Optional.
        addressLine2 string

Optional.
        postalCode string

Optional.
        city string

Optional.
        countryCode string

Optional.
        country string

Optional.
      recipientHandlingAddress object

Required.
        addressLine1 string

Optional.
        addressLine2 string

Optional.
        postalCode string

Optional.
        city string

Optional.
        countryCode string

Optional.
        country string

Optional.
      senderReference string

Required.
      senderCustomerNumber string

Required.
      senderCustomerMasterNumber string

Required.
      senderName string

Required.
      senderAddress object

Required.
        addressLine1 string

Optional.
        addressLine2 string

Optional.
        postalCode string

Optional.
        city string

Optional.
        countryCode string

Optional.
        country string

Optional.
      senderCustomerType string

Required.
      recipientCustomerNumber string

Required.
      recipientCustomerMasterNumber string

Required.
      recipientCustomerType string

Required.
      isPickupNoticeAvailable boolean

Required.
      consignmentActionSet object

Required.
        actionType string

Required.
        actionURL string

Required.
      totalWeightInKgs number

Required.
      totalVolumeInDm3 number

Required.
apiVersion object

Required.

The example below is showing a package that have been EDI notified, but is not received by Bring.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ConsignmentSet xmlns="http://www.bring.no/sporing/2.0">
  <ApiVersion>2</ApiVersion>
  <Consignment xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="packageCargoConsignmentType" consignmentId="SHIPMENTNUMBER" previousConsignmentId="">
    <TotalWeight unitCode="kg">16.5</TotalWeight>
    <TotalVolume unitCode="dm3">45.2</TotalVolume>
    <SenderReference></SenderReference>
    <SenderCustomerNumber></SenderCustomerNumber>
    <SenderCustomerMasterNumber></SenderCustomerMasterNumber>
    <SenderName>POSTEN NORGE AS</SenderName>
    <SenderAddress>
      <AddressLine1></AddressLine1>
      <AddressLine2></AddressLine2>
      <PostalCode></PostalCode>
      <City></City>
      <CountryCode></CountryCode>
      <Country></Country>
    </SenderAddress>
    <SenderCustomerType></SenderCustomerType>
    <RecipientCustomerNumber></RecipientCustomerNumber>
    <RecipientCustomerMasterNumber></RecipientCustomerMasterNumber>
    <RecipientCustomerType></RecipientCustomerType>
    <RecipientHandlingAddress>
      <AddressLine1></AddressLine1>
      <AddressLine2></AddressLine2>
      <PostalCode>1407</PostalCode>
      <City>VINTERBRO</City>
      <CountryCode></CountryCode>
      <Country></Country>
    </RecipientHandlingAddress>
    <PackageSet>
      <Package packageId="TESTPACKAGEATPICKUPPOINT" previousPackageId="">
        <StatusDescription>Package can be collected at pickup point.</StatusDescription>
        <Descriptions/>
        <ProductName>CARBON-NEUTRAL SERVICE PARCEL</ProductName>
        <ProductCode>1202</ProductCode>
        <ProductLink>http://www.bring.no/english/shortcuts/1202</ProductLink>
        <Brand>POSTEN</Brand>
        <Weight unitCode="kg">16.5</Weight>
        <Length unitCode="cm">41</Length>
        <Width unitCode="cm">38</Width>
        <Height unitCode="cm">29</Height>
        <Volume unitCode="dm3">45.2</Volume>
        <PickupCode>AA11</PickupCode>
        <LastRetrievalDate>01.12.2011</LastRetrievalDate>
        <SenderName>POSTEN NORGE AS</SenderName>
        <SenderAddress>
          <AddressLine1></AddressLine1>
          <AddressLine2></AddressLine2>
          <PostalCode></PostalCode>
          <City></City>
          <CountryCode></CountryCode>
          <Country></Country>
        </SenderAddress>
        <RecipientHandlingAddress>
          <AddressLine1></AddressLine1>
          <AddressLine2></AddressLine2>
          <PostalCode>1407</PostalCode>
          <City>VINTERBRO</City>
          <CountryCode></CountryCode>
          <Country></Country>
        </RecipientHandlingAddress>
        <EventSet>
          <Event xsi:type="packageCargoEventType">
            <Description>The shipment has arrived at pickup point.</Description>
            <Status>READY_FOR_PICKUP</Status>
            <RecipientSignature>
              <Name></Name>
            </RecipientSignature>
            <UnitId>122608</UnitId>
            <UnitInformationUrl>https://api.bring.com/pickuppoint/api/pickuppoint/NO/id/122608.xml</UnitInformationUrl>
            <UnitType>BRING</UnitType>
            <PostalCode>2341</PostalCode>
            <City>LØTEN</City>
            <CountryCode>NO</CountryCode>
            <Country>Norway</Country>
            <OccuredAtIsoDateTime>2010-10-01T08:30:25.000+02:00</OccuredAtIsoDateTime>
            <OccuredAtDisplayDate>01.10.2010</OccuredAtDisplayDate>
            <OccuredAtDisplayTime>08.30</OccuredAtDisplayTime>
            <ConsignmentEvent>false</ConsignmentEvent>
            <Insignificant>false</Insignificant>
          </Event>
          <Event xsi:type="packageCargoEventType">
            <Description>The shipment has been handed in at terminal and forwarded.</Description>
            <Status>IN_TRANSIT</Status>
            <RecipientSignature>
              <Name></Name>
            </RecipientSignature>
            <UnitId>032850</UnitId>
            <UnitType>BRING</UnitType>
            <PostalCode>0024</PostalCode>
            <City>OSLO</City>
            <CountryCode>NO</CountryCode>
            <Country>Norway</Country>
            <OccuredAtIsoDateTime>2010-09-30T08:27:08.000+02:00</OccuredAtIsoDateTime>
            <OccuredAtDisplayDate>30.09.2010</OccuredAtDisplayDate>
            <OccuredAtDisplayTime>08.27</OccuredAtDisplayTime>
            <ConsignmentEvent>false</ConsignmentEvent>
            <Insignificant>false</Insignificant>
          </Event>
        </EventSet>
        <AdditionalServicesSet/>
      </Package>
    </PackageSet>
    <IsPickupNoticeAvailable>false</IsPickupNoticeAvailable>
  </Consignment>
</ConsignmentSet>

Returned upon no search responses being returned for the request itself

No shipments found

The example below is showing a package that have been EDI notified, but is not received by Bring.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ConsignmentSet xmlns="http://www.bring.no/sporing/2.0">
  <ApiVersion>2</ApiVersion>
  <Consignment xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="packageCargoConsignmentType" consignmentId="SHIPMENTNUMBER" previousConsignmentId="">
    <TotalWeight unitCode="kg">16.5</TotalWeight>
    <TotalVolume unitCode="dm3">45.2</TotalVolume>
    <SenderReference></SenderReference>
    <SenderCustomerNumber></SenderCustomerNumber>
    <SenderCustomerMasterNumber></SenderCustomerMasterNumber>
    <SenderCustomerType></SenderCustomerType>
    <RecipientCustomerNumber></RecipientCustomerNumber>
    <RecipientCustomerMasterNumber></RecipientCustomerMasterNumber>
    <RecipientCustomerType></RecipientCustomerType>
    <PackageSet>
      <Package packageId="TESTPACKAGEEDI" previousPackageId="">
        <StatusDescription>Norway Post/Bring has received a message from sender that a package is on its way, but has not yet received the package. In case of questions, please contact the sender</StatusDescription>
        <Descriptions/>
        <ProductName>HOME DELIVERY</ProductName>
        <ProductCode>1736</ProductCode>
        <ProductLink>http://www.bring.no/english/shortcuts/1736</ProductLink>
        <Brand>POSTEN</Brand>
        <Weight unitCode="kg">16.5</Weight>
        <Length unitCode="cm">41</Length>
        <Width unitCode="cm">38</Width>
        <Height unitCode="cm">29</Height>
        <Volume unitCode="dm3">45.2</Volume>
        <EventSet>
          <Event xsi:type="packageCargoEventType">
            <Description>No shipment has been received yet, only notification of the shipment.</Description>
            <Status>PRE_NOTIFIED</Status>
            <RecipientSignature>
              <Name></Name>
            </RecipientSignature>
            <UnitId>904030</UnitId>
            <UnitType>BRING</UnitType>
            <PostalCode></PostalCode>
            <City></City>
            <CountryCode></CountryCode>
            <Country></Country>
            <OccuredAtIsoDateTime>2018-05-24T12:44:12.000+02:00</OccuredAtIsoDateTime>
            <OccuredAtDisplayDate>24.05.2018</OccuredAtDisplayDate>
            <OccuredAtDisplayTime>12.44</OccuredAtDisplayTime>
            <ConsignmentEvent>false</ConsignmentEvent>
            <Insignificant>false</Insignificant>
          </Event>
        </EventSet>
        <AdditionalServicesSet/>
      </Package>
    </PackageSet>
    <IsPickupNoticeAvailable>false</IsPickupNoticeAvailable>
  </Consignment>
</ConsignmentSet>

The example below is showing a package waiting for the recipient to collect it at a pickup point

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ConsignmentSet xmlns="http://www.bring.no/sporing/2.0">
  <ApiVersion>2</ApiVersion>
  <Consignment xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="packageCargoConsignmentType" consignmentId="SHIPMENTNUMBER" previousConsignmentId="">
    <TotalWeight unitCode="kg">16.5</TotalWeight>
    <TotalVolume unitCode="dm3">45.2</TotalVolume>
    <SenderReference></SenderReference>
    <SenderCustomerNumber></SenderCustomerNumber>
    <SenderCustomerMasterNumber></SenderCustomerMasterNumber>
    <SenderName>POSTEN NORGE AS</SenderName>
    <SenderAddress>
      <AddressLine1></AddressLine1>
      <AddressLine2></AddressLine2>
      <PostalCode></PostalCode>
      <City></City>
      <CountryCode></CountryCode>
      <Country></Country>
    </SenderAddress>
    <SenderCustomerType></SenderCustomerType>
    <RecipientCustomerNumber></RecipientCustomerNumber>
    <RecipientCustomerMasterNumber></RecipientCustomerMasterNumber>
    <RecipientCustomerType></RecipientCustomerType>
    <RecipientHandlingAddress>
      <AddressLine1></AddressLine1>
      <AddressLine2></AddressLine2>
      <PostalCode>1407</PostalCode>
      <City>VINTERBRO</City>
      <CountryCode></CountryCode>
      <Country></Country>
    </RecipientHandlingAddress>
    <PackageSet>
      <Package packageId="TESTPACKAGEATPICKUPPOINT" previousPackageId="">
        <StatusDescription>Package can be collected at pickup point.</StatusDescription>
        <Descriptions/>
        <ProductName>CARBON-NEUTRAL SERVICE PARCEL</ProductName>
        <ProductCode>1202</ProductCode>
        <ProductLink>http://www.bring.no/english/shortcuts/1202</ProductLink>
        <Brand>POSTEN</Brand>
        <Weight unitCode="kg">16.5</Weight>
        <Length unitCode="cm">41</Length>
        <Width unitCode="cm">38</Width>
        <Height unitCode="cm">29</Height>
        <Volume unitCode="dm3">45.2</Volume>
        <PickupCode>AA11</PickupCode>
        <LastRetrievalDate>01.12.2011</LastRetrievalDate>
        <SenderName>POSTEN NORGE AS</SenderName>
        <SenderAddress>
          <AddressLine1></AddressLine1>
          <AddressLine2></AddressLine2>
          <PostalCode></PostalCode>
          <City></City>
          <CountryCode></CountryCode>
          <Country></Country>
        </SenderAddress>
        <RecipientHandlingAddress>
          <AddressLine1></AddressLine1>
          <AddressLine2></AddressLine2>
          <PostalCode>1407</PostalCode>
          <City>VINTERBRO</City>
          <CountryCode></CountryCode>
          <Country></Country>
        </RecipientHandlingAddress>
        <EventSet>
          <Event xsi:type="packageCargoEventType">
            <Description>The shipment has arrived at pickup point.</Description>
            <Status>READY_FOR_PICKUP</Status>
            <RecipientSignature>
              <Name></Name>
            </RecipientSignature>
            <UnitId>122608</UnitId>
            <UnitInformationUrl>https://api.bring.com/pickuppoint/api/pickuppoint/NO/id/122608.xml</UnitInformationUrl>
            <UnitType>BRING</UnitType>
            <PostalCode>2341</PostalCode>
            <City>LØTEN</City>
            <CountryCode>NO</CountryCode>
            <Country>Norway</Country>
            <OccuredAtIsoDateTime>2010-10-01T08:30:25.000+02:00</OccuredAtIsoDateTime>
            <OccuredAtDisplayDate>01.10.2010</OccuredAtDisplayDate>
            <OccuredAtDisplayTime>08.30</OccuredAtDisplayTime>
            <ConsignmentEvent>false</ConsignmentEvent>
            <Insignificant>false</Insignificant>
          </Event>
          <Event xsi:type="packageCargoEventType">
            <Description>The shipment has been handed in at terminal and forwarded.</Description>
            <Status>IN_TRANSIT</Status>
            <RecipientSignature>
              <Name></Name>
            </RecipientSignature>
            <UnitId>032850</UnitId>
            <UnitType>BRING</UnitType>
            <PostalCode>0024</PostalCode>
            <City>OSLO</City>
            <CountryCode>NO</CountryCode>
            <Country>Norway</Country>
            <OccuredAtIsoDateTime>2010-09-30T08:27:08.000+02:00</OccuredAtIsoDateTime>
            <OccuredAtDisplayDate>30.09.2010</OccuredAtDisplayDate>
            <OccuredAtDisplayTime>08.27</OccuredAtDisplayTime>
            <ConsignmentEvent>false</ConsignmentEvent>
            <Insignificant>false</Insignificant>
          </Event>
        </EventSet>
        <AdditionalServicesSet/>
      </Package>
    </PackageSet>
    <IsPickupNoticeAvailable>false</IsPickupNoticeAvailable>
  </Consignment>
</ConsignmentSet>

The example below is showing a package that has been loaded on a distribution car for delivery to the reciepient.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ConsignmentSet xmlns="http://www.bring.no/sporing/2.0">
  <ApiVersion>2</ApiVersion>
  <Consignment xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="packageCargoConsignmentType" consignmentId="SHIPMENTNUMBER" previousConsignmentId="">
    <TotalWeight unitCode="kg">16.5</TotalWeight>
    <TotalVolume unitCode="dm3">45.2</TotalVolume>
    <SenderReference></SenderReference>
    <SenderCustomerNumber></SenderCustomerNumber>
    <SenderCustomerMasterNumber></SenderCustomerMasterNumber>
    <SenderCustomerType></SenderCustomerType>
    <RecipientCustomerNumber></RecipientCustomerNumber>
    <RecipientCustomerMasterNumber></RecipientCustomerMasterNumber>
    <RecipientCustomerType></RecipientCustomerType>
    <PackageSet>
      <Package packageId="TESTPACKAGELOADEDFORDELIVERY" previousPackageId="">
        <StatusDescription>Package will be delivered to recipient this evening between 1700 and 2100. The driver will call 30 - 60 minutes before delivery</StatusDescription>
        <Descriptions/>
        <ProductName>HOME DELIVERY</ProductName>
        <ProductCode>1736</ProductCode>
        <ProductLink>http://www.bring.no/english/shortcuts/1736</ProductLink>
        <Brand>POSTEN</Brand>
        <Weight unitCode="kg">16.5</Weight>
        <Length unitCode="cm">41</Length>
        <Width unitCode="cm">38</Width>
        <Height unitCode="cm">29</Height>
        <Volume unitCode="dm3">45.2</Volume>
        <EventSet>
          <Event xsi:type="packageCargoEventType">
            <Description>The shipment has been loaded for delivery.</Description>
            <Status>TRANSPORT_TO_RECIPIENT</Status>
            <RecipientSignature>
              <Name></Name>
            </RecipientSignature>
            <UnitId>971190</UnitId>
            <UnitType>BRING</UnitType>
            <PostalCode>0001</PostalCode>
            <City>OSLO</City>
            <CountryCode>NO</CountryCode>
            <Country>Norway</Country>
            <OccuredAtIsoDateTime>2010-09-30T16:48:57.000+02:00</OccuredAtIsoDateTime>
            <OccuredAtDisplayDate>30.09.2010</OccuredAtDisplayDate>
            <OccuredAtDisplayTime>16.48</OccuredAtDisplayTime>
            <ConsignmentEvent>false</ConsignmentEvent>
            <Insignificant>false</Insignificant>
          </Event>
          <Event xsi:type="packageCargoEventType">
            <Description>The shipment has been handed in at terminal and forwarded.</Description>
            <Status>IN_TRANSIT</Status>
            <RecipientSignature>
              <Name></Name>
            </RecipientSignature>
            <UnitId>032850</UnitId>
            <UnitType>BRING</UnitType>
            <PostalCode>0024</PostalCode>
            <City>OSLO</City>
            <CountryCode>NO</CountryCode>
            <Country>Norway</Country>
            <OccuredAtIsoDateTime>2010-09-30T08:27:08.000+02:00</OccuredAtIsoDateTime>
            <OccuredAtDisplayDate>30.09.2010</OccuredAtDisplayDate>
            <OccuredAtDisplayTime>08.27</OccuredAtDisplayTime>
            <ConsignmentEvent>false</ConsignmentEvent>
            <Insignificant>false</Insignificant>
          </Event>
        </EventSet>
        <AdditionalServicesSet/>
      </Package>
    </PackageSet>
    <IsPickupNoticeAvailable>false</IsPickupNoticeAvailable>
  </Consignment>
</ConsignmentSet>

The example below is showing a package that has been delivered to the reciepient.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ConsignmentSet xmlns="http://www.bring.no/sporing/2.0">
  <ApiVersion>2</ApiVersion>
  <Consignment xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="packageCargoConsignmentType" consignmentId="SHIPMENTNUMBER" previousConsignmentId="">
    <TotalWeight unitCode="kg">16.5</TotalWeight>
    <TotalVolume unitCode="dm3">45.2</TotalVolume>
    <SenderReference></SenderReference>
    <SenderCustomerNumber></SenderCustomerNumber>
    <SenderCustomerMasterNumber></SenderCustomerMasterNumber>
    <SenderCustomerType></SenderCustomerType>
    <RecipientCustomerNumber></RecipientCustomerNumber>
    <RecipientCustomerMasterNumber></RecipientCustomerMasterNumber>
    <RecipientCustomerType></RecipientCustomerType>
    <PackageSet>
      <Package packageId="TESTPACKAGEDELIVERED" previousPackageId="">
        <StatusDescription></StatusDescription>
        <Descriptions/>
        <ProductName>HOME DELIVERY</ProductName>
        <ProductCode>1736</ProductCode>
        <ProductLink>http://www.bring.no/english/shortcuts/1736</ProductLink>
        <Brand>POSTEN</Brand>
        <Weight unitCode="kg">16.5</Weight>
        <Length unitCode="cm">41</Length>
        <Width unitCode="cm">38</Width>
        <Height unitCode="cm">29</Height>
        <Volume unitCode="dm3">45.2</Volume>
        <EventSet>
          <Event xsi:type="packageCargoEventType">
            <Description>The shipment has been delivered.</Description>
            <Status>DELIVERED</Status>
            <RecipientSignature>
              <Name>O Nordmann</Name>
            </RecipientSignature>
            <UnitId>971190</UnitId>
            <UnitType>BRING</UnitType>
            <PostalCode></PostalCode>
            <City></City>
            <CountryCode></CountryCode>
            <Country></Country>
            <OccuredAtIsoDateTime>2010-09-30T17:45:25.000+02:00</OccuredAtIsoDateTime>
            <OccuredAtDisplayDate>30.09.2010</OccuredAtDisplayDate>
            <OccuredAtDisplayTime>17.45</OccuredAtDisplayTime>
            <ConsignmentEvent>false</ConsignmentEvent>
            <Insignificant>false</Insignificant>
          </Event>
          <Event xsi:type="packageCargoEventType">
            <Description>The shipment has been loaded for delivery.</Description>
            <Status>TRANSPORT_TO_RECIPIENT</Status>
            <RecipientSignature>
              <Name></Name>
            </RecipientSignature>
            <UnitId>971190</UnitId>
            <UnitType>BRING</UnitType>
            <PostalCode>0001</PostalCode>
            <City>OSLO</City>
            <CountryCode>NO</CountryCode>
            <Country>Norway</Country>
            <OccuredAtIsoDateTime>2010-09-30T16:48:57.000+02:00</OccuredAtIsoDateTime>
            <OccuredAtDisplayDate>30.09.2010</OccuredAtDisplayDate>
            <OccuredAtDisplayTime>16.48</OccuredAtDisplayTime>
            <ConsignmentEvent>false</ConsignmentEvent>
            <Insignificant>false</Insignificant>
          </Event>
          <Event xsi:type="packageCargoEventType">
            <Description>The shipment has been handed in at terminal and forwarded.</Description>
            <Status>IN_TRANSIT</Status>
            <RecipientSignature>
              <Name></Name>
            </RecipientSignature>
            <UnitId>032850</UnitId>
            <UnitType>BRING</UnitType>
            <PostalCode>0024</PostalCode>
            <City>OSLO</City>
            <CountryCode>NO</CountryCode>
            <Country>Norway</Country>
            <OccuredAtIsoDateTime>2010-09-30T08:27:08.000+02:00</OccuredAtIsoDateTime>
            <OccuredAtDisplayDate>30.09.2010</OccuredAtDisplayDate>
            <OccuredAtDisplayTime>08.27</OccuredAtDisplayTime>
            <ConsignmentEvent>false</ConsignmentEvent>
            <Insignificant>false</Insignificant>
          </Event>
        </EventSet>
        <AdditionalServicesSet/>
      </Package>
    </PackageSet>
    <IsPickupNoticeAvailable>false</IsPickupNoticeAvailable>
  </Consignment>
</ConsignmentSet>