Getting status updates

Retrieving a tracking from parcelLab refers to the act of requesting the information about a certain delivery from parcelLab. We call this information about the progress up to now the checkpoints.

get
Get checkpoints

https://api.parcellab.com/v2/checkpoints/
Retrieves the current status of a tracking or an order.
Request
Response
Query Parameters
tno
required
string
Tracking number
courier
required
string
Courier code
lang
optional
string
Language as ISO 3166-1 alpha-3, defaults to en
200: OK
For more details of the response please see below.
{
"header": [
{
"id": "579f6444b6a1bb4fbaab5610",
"tracking_number": "00340000000000000001",
"courier": {
"name": "dhl-germany",
"prettyname": "DHL",
"trackingurl": "https://nolp.dhl.de/ne~~~00001",
"trackingurl_label": "Klicken Sie hier fΓΌr weitere Informationen zur Sendung."
},
"last_delivery_status": {
"status": "Zugestellt",
"status_details": "Die Ware wurde erfolgreich zugestellt.",
"code": "Delivered"
},
"delay": false,
"exception": false
}
],
"body": {
"579f6444b6a1bb4fbaab5610": [
{
"shown": true,
"status": "OrderProcessed",
"status_text": "Bestellung verarbeitet",
"status_details": "Die Bestellung wurde verarbeitet.",
"full_courier_status": "If exists, date of order, else date of import to parcelLab",
"location": "Sample City",
"timestamp": "2015-08-10T15:18:27.000Z"
}
]
}
}

The return of a successful call of this endpoint yields status code 200 OK and a JSON encoded response object. This object consists of a header and body.

Return Header

The header is an array listing an overview over all trackings returned. When requesting the API like documented here with a combination of courier and tracking_number the array with always have header.length === 1.

The overview for each tracking is structured like this:

Key

Type

Description

id

String

id of the tracking which serves as key in the body

tracking_number

String

tracking number of the tracking

courier

Object

details about the courier, explained below

last_delivery_status

Object

details about the current status of the tracking

delay

Boolean

true if a delay of this delivery has been detected by parcelLab

exception

Boolean

true if an escalated problem has been detected

Return object courier

Key

Type

Description

name

String

the courier code (e.g. dhl-germany )

prettyname

String

pretty name of the courier to be displayed (e.g. DHL )

trackingurl

String

URL of courier's own tracking page

trackingurl_label

String

localised label for trackingurl

Return object last_delivery_status

Key

Type

Description

status

String

see below in description of checkpoints

status_details

String

see below in description of checkpoints

code

String

see below in description of checkpoints

Return Body

The body simply is an object where for each tracking in the header, identified by their id, an array of checkpoints is given. This array has the following structure:

Key

Type

Description

shown

Boolean

parcelLab automatically filters checkpoints provided by the courier which are unclear and do not help the recipient to understand the current status of the delivery. These unclear status are marked with false .

status

String

One of the parcelLab status codes

status_text

String

A localised short description of the current status of the delivery

status_details

String

A localised longer, more detailed description of the current status of the delivery

full_courier_status

String

The full status code provided by the courier for reference, not recommended to display to recipient

location

String

Location of checkpoint if available, else empty string ""

timestamp

String

Date and time of checkpoint formatted as Date.prototype.toJSON()​

Alternatively, a request can be performed using the orderNo:

get
Get checkpoints via order number

https://api.parcellab.com/v2/checkpoints
Alternative request structure with orderNo, response as described above.
Request
Response
Query Parameters
u
required
number
User ID in parcelLab
orderNo
required
string
Assigned order number
lang
optional
string
Language as ISO 3166-1 alpha-3, defaults to en
200: OK
As above
​