Info
  • Web service URL: BASE_URL/api/Track/by-awb/with-return


TABLE OF CONTENTS


1 Get Track statuses - complete (POST Method)

Request body

NameTypeRequiredDescription
courierint | stringYesCourier Id or Courier name - See Couriers table
awbListstring []YesComma separated Awbs - limit 200

Track Response

NameTypeDescription
orderIdintInnoship Order Id
externalOrderIdstringExternal order id
correlationId
string
courierintSee Couriers table
shipmentAwbstringCourier AWB number
carrierMeasuredWeightdoublereweight info (if exists)
recipientContactName
string
recipient contact name 
recipientLocality
string
recipient locality
recipientCountryCode
string
recipient two letters country code
trackUrl
string
trackURL for Innoship tracking page
currentStatus
string
last status of shipment - See Status table 
currentStatusId
intlast statusId of shipment - See  Status table
historyHistory []Event history for main AWB
returnAwbstringReturn AWB number if exists
returnAwbHistoryHistory []Event history for return AWB
cashOnDeliveryHistoryHistory []Event history for cod AWB

History [] :

NameTypeDescription
clientStatusIdintSee Statuses Table
clientStatusDescriptionstringText description of status
eventDateDateDate of event from courier
isFinalStatusbooleanTrue if this is a final status
localityName
stringLocality name


1.1 Track service response example

200 - Response 

[
    {
        "returnAwb": null,
        "returnAwbHistory": [],
        "orderId": 26072799,
        "externalOrderId": null,
        "correlationId": null,
        "courier": 1,
        "shipmentAwb": "990923033",
        "carrierMeasuredWeight": 0.2,
        "recipientContactName": "Mihai Cosmin",
        "recipientLocality": "Sector 6",
        "recipientCountryCode": "RO",
        "trackUrl": "https://track.innoship.io/wvbVbbrjdEm4HXjMRxfkFQ",
        "currentStatus": "Delivered",
        "currentStatusId": 100,
        "history": [
            {
                "clientStatusId": 1,
                "clientStatusDescription": "New",
                "eventDate": "2022-11-21T15:49:34.932029",
                "isFinalStatus": false,
                "localityName": null
            },
            {
                "clientStatusId": 2,
                "clientStatusDescription": "Picked-Up",
                "eventDate": "2022-11-21T16:08:10",
                "isFinalStatus": false,
                "localityName": "BUCURESTI"
            },
            {
                "clientStatusId": 10,
                "clientStatusDescription": "In Courier WH",
                "eventDate": "2022-11-21T17:56:24",
                "isFinalStatus": false,
                "localityName": "BUCURESTI"
            },
            {
                "clientStatusId": 30,
                "clientStatusDescription": "Out for Delivery",
                "eventDate": "2022-11-22T06:43:19",
                "isFinalStatus": false,
                "localityName": "BUCURESTI"
            },
            {
                "clientStatusId": 42,
                "clientStatusDescription": "Scheduled",
                "eventDate": "2022-11-22T15:56:18",
                "isFinalStatus": false,
                "localityName": "BUCURESTI"
            },
            {
                "clientStatusId": 10,
                "clientStatusDescription": "In Courier WH",
                "eventDate": "2022-11-23T01:21:10",
                "isFinalStatus": false,
                "localityName": "BUCURESTI"
            },
            {
                "clientStatusId": 30,
                "clientStatusDescription": "Out for Delivery",
                "eventDate": "2022-11-23T06:18:46",
                "isFinalStatus": false,
                "localityName": "BUCURESTI"
            },
            {
                "clientStatusId": 100,
                "clientStatusDescription": "Delivered",
                "eventDate": "2022-11-23T11:30:03",
                "isFinalStatus": true,
                "localityName": "BUCURESTI"
            }
        ],
        "cashOnDeliveryHistory": [
            {
                "clientStatusId": 1,
                "clientStatusDescription": "New",
                "eventDate": "2022-11-21T15:49:34.93203",
                "isFinalStatus": false,
                "localityName": null
            }
        ]
    }
]

400 - Bad request 

"errors": [
        {
            "message": "Invalid request. Incorrect AWB list provided",
            "details": null
        }
    ],
    "correlationId": null
}