Tracking
These endpoints can be used to get and update the shipment tracking information
Get Shipment Tracking
GET https://api-sandbox.shiplemon.com/public/v1/shipments/:id/tracking
This endpoint allows you to retrieve the shipment tracking information for a given shipmentId.
Update interval:
Call this endpoint every hour at :05 and :35.
{
"status": "ok",
"data": {
"partner_id": "partner_id",
"driver": "elta",
"carrier": {
"code": "elta",
"name": "ELTA Courier",
"image": "https://static.shiplemon.com/providers/eltacourier.svg"
},
"service": {
"code": "elta_courier_porta_porta",
"name": "Porta-Porta",
"estimated_delivery_in_days": 6
},
"tracking_status": "DELIVERED",
"tracking_history": [
{
"status": "DELIVERED",
"status_exact": null,
"status_date": "2024-07-15T10:02:00.000Z",
"status_details": "ΠΑΡΑΛΑΒΗ ΑΠΟ ΣΤΑΘΜΟ ΜΕ ΔΗΛΩΣΗ ΠΑΡΑΛΗΠΤΗ"
},
{
"status": "TRANSIT",
"status_exact": "WITH_COURIER",
"status_date": "2024-07-15T09:45:00.000Z",
"status_details": "ΠΡΟΣ ΠΑΡΑΔΟΣΗ"
},
{
"status": "PRE_TRANSIT",
"status_exact": null,
"status_date": "2024-07-12T14:17:00.000Z",
"status_details": "ΔΗΜΙΟΥΡΓΙΑ ΣΥ.ΔΕ.ΤΑ. ΑΠΟ ΠΕΛΑΤΗ"
}
],
"tracking_ref": "tracking_ref",
"tracking_url": "tracking_url",
"country_from": "GR",
"country_to": "GR"
}
}Update Shipment Tracking
PUT https://api-sandbox.shiplemon.com/v1/shipments/:id/tracking
This endpoint allows you to update the shipment tracking with the given shipmentId
Path Parameters
| Name | Type | Description |
|---|---|---|
id | string | The `id` of the shipment that needs to be updated. |
tracking_history | array | The payload should always include the entire tracking history. |
Accepted values
The status and status_date have specific format as shown below:
status: DELIVERED, TRANSIT, PRE_TRANSIT, EXCEPTION (case sensitive)
status_date: must be in ISO 8601 format (YYYY-MM-DDTHH:MM:SS.sssZ)
{
"status": "ok",
"data": {
"id": "60476d7500e47cb69693a202",
"driver": "dhl",
"pickup_ref": "CBJ180121002626",
"tracking_ref": "1190953890",
"tracking_url": "http://www.dhl-usa.com/content/us/en/express/tracking.shtml?brand=DHL&AWB=1190953890",
"tracking_status": "PRE_TRANSIT",
"tracking_history": [
{
"status": "DELIVERED",
"status_date": "2023-11-20T00:00:01.992Z",
"status_details": "ΠΑΡΑΔΟΣΗ ΑΠΟ ΔΙΑΝΟΜΕΑ"
},
{
"status": "EXCEPTION",
"status_date": "2023-11-20T00:00:02.195Z",
"status_details": "ΑΚΥΡΩΣΗ ΑΠΟ ΔΙΑΝΟΜΕΑ"
},
{
"status": "TRANSIT",
"status_date": "2023-11-20T00:00:02.075Z",
"status_details": "ΕΚΦΟΡΤΩΣΗ ΑΠΟ ΜΕΤΑΦΟΡΙΚΟ ΜΕΣΟ"
},
{
"status": "PRE_TRANSIT",
"status_date": "2023-11-20T00:00:02.064Z",
"status_details": "ΔΗΜΙΟΥΡΓΙΑ ΣΥ.ΔΕ.ΤΑ. ΑΠΟ ΠΕΛΑΤΗ"
}
],
"tracking_history_last_updated_at": "2022-08-08T09:15:00.947Z",
"label_url": "https://static.shiplemon.com/sandbox/labels/ups/1ZXXXXXXXXXXXXXXXX.pdf",
"child_vouchers": [
{
"tracking_ref": "2338891501",
"tracking_url": "",
"label_url": "https://static.shiplemon.com/sandbox/labels/boxnow/2338891501.pdf"
}
],
"label_url": "https://deliver.goshippo.com/2519d201e88b4be8a3500a84c1608374.pdf?Expires=1646829812&Signature=qjByvemk0FAA7fnKPpCtd~Almiz96cFGmKyGseVNSBD~sYu4b4Q5EdG~WEhjFRefknu5HQnA76P3YTEh2NGRYL~fRGeueyjPEEpqW~V1E5WIHkJBnpVDJFKutwevlryOPBDy0x3Px-KY7iFUgagDdofg4lPIoD-PZnWffPapgT1xZUZS~9esQOEcAqdrBPuSO1i3ufdBCJLRIoM7XALD2-VmWcQWi2qS5YokKDEcEuRj88lcBIxiY9V9Wp~cNukLidrJlEVmvsFPhBzY6Y5M5xwIrTKFZSyeTs-B7rZQUgE5jSvA7YNcm0raw-N2t72om47BXKp0uVKEtinQ6TUnOQ__&Key-Pair-Id=APKAJRICFXQ2S4YUQRSQ",
"invoice_url": null,
"address_from": {
"country": "GR",
"zip": "14451",
"name": "SG1",
"state": "I",
"city": "Athens",
"address": "Ermou 3",
"email": "example@gmail.com",
"phone": "+306933000000",
"notes": ""
},
"address_to": {
"name": "SG2",
"country": "GR",
"state": "I",
"city": "Athens",
"zip": "14451",
"address": "Dimosthenous 45",
"email": "example@gmail.com",
"phone": "+306933000000"
},
"items": [
{
"weight": 2000,
"height": 10,
"width": 30,
"length": 20,
"notes": "Nike air max",
"value": 10,
"currency": "EUR"
},
{
"weight": 2000,
"height": 10,
"width": 30,
"length": 20,
"notes": "Nike air max",
"value": 10,
"currency": "EUR"
}
],
"pickup": {
"date": "2021-03-12",
"time": "09:00-18:00"
},
"rate": {
"id": "dhl_dhlexpress-domesticexpressdoc_20531b76ce4943bb95c51509fc6e945d",
"driver": "dhl",
"provider": {
"name": "DHL Express",
"image": "https://shippo-static.s3.amazonaws.com/providers/200/DHL.png"
},
"service": {
"name": "DOMESTIC EXPRESS DOC",
"estimated_delivery_in_days": 1
},
"total_amount": 26.34,
"currency": "EUR",
"printing_required": true,
"transportation": "road",
"metadata": {
"items": [
{
"weight": 2000,
"height": 10,
"width": 30,
"length": 20,
"notes": "Nike air max",
"value": 10,
"currency": "EUR"
},
{
"weight": 2000,
"height": 10,
"width": 30,
"length": 20,
"notes": "Nike air max",
"value": 10,
"currency": "EUR"
}
],
"address_from": {
"country": "GR",
"zip": "14451"
},
"address_to": {
"country": "GR",
"zip": "14121"
}
}
}
}
}Example Request
curl --location --request PUT 'https://api-sandbox.shiplemon.com/v1/shipments/<shipment_id>/tracking' \
--header 'x-api-key: <YOUR_API_KEY>' \
--header 'Content-Type: application/json'Example response
{
"status":"ok",
"data":{
"id":"be96511d-ba23-4268-bd8b-48c9cf930222",
"partner_id":"partner_id",
"invoice_id":null,
"partner_credentials_used":true,
"related_order_id":null,
"payment_ref":null,
"payment_amount":null,
"state":"created",
"driver":"elta",
"pickup_ref":null,
"tracking_ref":"tracking_ref",
"tracking_url":"https://www.elta-courier.gr/search?br=ZU500011420GR",
"tracking_status":"PRE_TRANSIT",
"tracking_history":[
{
"status": "DELIVERED",
"status_date": "2023-11-20T00:00:01.992Z",
"status_details": "ΠΑΡΑΔΟΣΗ ΑΠΟ ΔΙΑΝΟΜΕΑ"
},
{
"status": "EXCEPTION",
"status_date": "2023-11-20T00:00:02.195Z",
"status_details": "ΑΚΥΡΩΣΗ ΑΠΟ ΔΙΑΝΟΜΕΑ"
},
{
"status": "TRANSIT",
"status_date": "2023-11-20T00:00:02.075Z",
"status_details": "ΕΚΦΟΡΤΩΣΗ ΑΠΟ ΜΕΤΑΦΟΡΙΚΟ ΜΕΣΟ"
},
{
"status": "PRE_TRANSIT",
"status_date": "2023-11-20T00:00:02.064Z",
"status_details": "ΔΗΜΙΟΥΡΓΙΑ ΣΥ.ΔΕ.ΤΑ. ΑΠΟ ΠΕΛΑΤΗ"
}
],
"tracking_history_last_updated_at": "2022-08-08T09:15:00.947Z",
"label_url": "https://static.shiplemon.com/sandbox/labels/ups/1ZXXXXXXXXXXXXXXXX.pdf",
"child_vouchers": [
{
"tracking_ref": "tracking_ref",
"tracking_url": "",
"label_url": "https://static.shiplemon.com/sandbox/labels/boxnow/2338891501.pdf"
}
],
"label_url":"https://static.shiplemon.com/labels/elta/ZU500011420GR.pdf",
"address_from":{
"_id":"61a15f9cfb38f514bd732222",
"country":"GR",
"company":"",
"name":"John Doe",
"phone":"+306912345678",
"email":"john@mail.com",
"address":"Jane Street 1",
"state":"I",
"city":"Athens",
"zip":"11111",
},
"address_to":{
"country":"GR",
"country_code":"GR",
"dial_code":"+30",
"name":"Mary Doe",
"zip":"11111",
"city":"Athns",
"address":"Jane Street 2",
"phone":"+306912345678"
},
"items":[{
"width":1,
"height":1,
"length":1,
"weight":5000,
"label":"Box",
"notes":"Box",
"invoice_lines":[]
}],
"pickup":null,
"pickup_at":null,
"delivered_at":null,
"rate":{
"id":"elta_1_790db74a-2b6f-4eaa-8918-60de9f192222",
"driver":"elta",
"provider":{
"name":"ELTA Courier",
"image":"https://static.shiplemon.com/providers/eltacourier.svg"
},
"service":{
"code":"elta_courier_porta_porta",
"name":"Porta-Porta",
"estimated_delivery_in_days":3
},
"total_amount":0,
"total_without_tax_amount":0,
"tax_amount":0,
"currency":"EUR",
"printing_required":true,
"has_cash_on_delivery":true,
"has_custom_credentials":true,
"has_shipment_pickup_combined":false,
"has_tracking_code_on_pickup":false,
"has_pickup":false,
"transportation":"road",
"metadata":{
"address_from":{
"_id":"61a15f9cfb38f514bd732222",
"country":"GR",
"company":"",
"name":"John Doe",
"phone":"+306912345678",
"email":"john@mail.com",
"address":"Jane Street 1",
"state":"I",
"city":"Athens",
"zip":"11111",
},
"address_to":{
"country":"GR",
"country_code":"GR",
"dial_code":"+30",
"name":"Mary Doe",
"zip":"11111",
"city":"Athns",
"address":"Jane Street 2",
"phone":"+306912345678"
},
"items":[{
"width":1,
"height":1,
"length":1,
"weight":5000,
"label":"Box",
"notes":"Box",
"invoice_lines":[]
}]
},
"cash_on_delivery":0,
"logs":[],
"tags":[],
"notifications":[],
"created_at":"2022-01-03T08:30:23.065Z",
"updated_at":"2022-01-03T08:30:23.081Z"
}
}Last updated