Get shipments
Get all the shipments created by your API key
Get Shipments
GET https://api-sandbox.shiplemon.com/v1/shipments
This endpoint allows you to get all shipments
{
"status": "ok",
"data": [
{},{},
{
"id": "60476d7500e47cb69693a202",
"driver": "dhl",
"pickup_ref": null,
"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": [],
"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": "giouldasis.stratos+sg1@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": null,
"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"
}
}
}
}
]
}Specific examples per language
curl --location --request GET 'https://api-sandbox.shiplemon.com/v1/shipments' \
--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":"6130aa18c713254a3719e222",
"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":"ZU500011420GR",
"tracking_url":"https://www.elta-courier.gr/search?br=ZU500011420GR",
"tracking_status":"PRE_TRANSIT",
"tracking_history":[],
"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"
}]
}Pagination
Response
{
"hasMore": false,
"hasNextPage": false,
"hasPrevPage": false,
"limit": 10,
"page": 1,
"pagingCounter": 1,
"totalDocs": 1,
"totalPages": 1
}Request (url params)
https://api-sandbox.shiplemon.com/v1/shipments?search=test&limit=10&page=1&tracking_status[]=PRE_TRANSIT&tracking_status[]=TRANSIT&tracking_status[]=DELIVERED&tracking_status[]=EXCEPTION&printed_status[]=printed&printed_status[]=pendingLast updated