Skip to main content

​
Overview

Retrieve detailed information about a parcel, including its current status, tracking URL, and complete event history. After an order enters the READY_TO_SHIP status, you can track the individual parcel statuses.

​
Get Parcel Details

Retrieve comprehensive tracking information for a parcel. 
curl -X GET 'https://hermes.api.e-cross.tech/ext/parcels/MERCHANT387294640090BR' \
  -H 'Authorization: Bearer YOUR_TOKEN'

{
  "merchantId": "MERCHANT",
  "parcelId": "MERCHANT918340981107MX",
  "salesChannel": "ECOM",
  "salesChannelOrderId": "1234567890",
  "senderCountry": "Spain",
  "recipientCountry": "Mexico",
  "status": "DELIVERED",
  "trackingUrl": "https://tracking.e-cross.tech/track/MERCHANT918340981107MX",
  "shipmentId": "18cda980-b2cd-478d-b5fc-6b23ea3feef9",
  "grossWeight": 1.01,
  "netWeight": 1,
  "volumetricWeight": 0.2,
  "lastMileTrackingNumber": "MMX123456789E",
  "creationDate": "2025-09-25T18:07:03.703Z",
  "deliveryEstimateDate": "2025-11-05T17:59:37.925Z",
  "lastUpdateDate": "2025-10-31T18:10:40.105Z",
  "invoiceDocumentUrl": "https://example.com/invoice.pdf",
  "invoiceNumber": "0000001",
  "labels": [
    {
      "labelUrl": "https://example.com/label.pdf",
      "lineHaulService": "FREIGHT_FORWARDER",
      "trackingNumber": "MMX123456789E"
    }
  ],
  "items": [
    {
      "hsCode": "640299",
      "itemWeight": 1,
      "productId": "123P",
      "quantity": 1,
      "skuId": "123",
      "skuName": "Sku name"
    }
  ],
  "events": [
    {
      "coreStatus": {
        "buyerStep": "CREATED",
        "code": "CREATED",
        "macroStep": "SHIPMENT_CREATED"
      },
      "description": "Order created",
      "eventDate": "2025-09-25T18:07:03.703Z",
      "receivedDate": "2025-09-25T18:07:03.703Z"
    },
    {
      "coreStatus": {
        "buyerStep": "DELIVERED",
        "code": "DELIVERED",
        "macroStep": "DELIVERED"
      },
      "description": "Delivered",
      "eventDate": "2025-10-31T17:41:08.000Z",
      "receivedDate": "2025-10-31T18:10:36.930Z"
    }
  ]
}

​
Path Parameters

​
parcelId
string
required
Parcel identifier. You can retrieve this from the order using: order.statusHistory[status="READY_FOR_SHIP"].eventData.parcelId

​
Response Fields

​
merchantId
string
required
Identifier of the merchant.
​
parcelId
string
required
Identifier of the parcel.
​
salesChannel
string
required
Identifier of the sales channel where the order was placed.
​
salesChannelOrderId
string
required
Identifier of the order in the sales channel.
​
senderCountry
string
required
Country where the parcel was dispatched from.
​
recipientCountry
string
required
Country where the parcel will be delivered to.
​
status
string
required
Status of the parcel (macro step of the logistic route). Can be one of:
  • SHIPMENT_CREATED - Parcel has been created
  • SHIPPED - Parcel has been shipped
  • ARRIVED_DESTINATION_COUNTRY - Parcel arrived in destination country, waiting for customs clearance
  • CUSTOMS_CLEARANCE - Parcel is in customs clearance process
  • LAST_MILE - Customs clearance completed, parcel delivered to last mile provider
  • DELIVERED - Parcel was delivered to the recipient
  • SHIPMENT_CANCELED - Parcel was cancelled and won’t be delivered
​
trackingUrl
string
required
Public tracking link sent to the buyer. This URL renders a web application to display trackings.
​
shipmentId
string
Identifier of the shipment in which the parcel is included, if any.
​
grossWeight
number
required
Estimated weight of the parcel in kg including packaging.
​
netWeight
number
required
Estimated weight of the parcel in kg without packaging.
​
volumetricWeight
number
required
Estimated volumetric weight of the parcel in kg.
​
lastMileTrackingNumber
string
required
Tracking number of the parcel in the last mile provider.
​
creationDate
string
required
Date when the parcel was created.
​
deliveryEstimateDate
string
required
Date of the estimated delivery of the parcel.
​
lastUpdateDate
string
required
Date of the last update of the parcel.
​
invoiceDocumentUrl
string
URL of the commercial invoice.
​
invoiceNumber
string
Number of the commercial invoice.
​
labels
array
Array of labels associated with the parcel.
​
items
array
required
Array of items included in the parcel.
​
events
array
required
Array of logistics events associated with the parcel.

​
Tracking Portal URL

The trackingUrl is a public URL that renders a web application to display trackings to the buyer. This URL is integrated from e-CROSS to the sales channel when the order enters the SHIPPED status, and then the sales channel sends the link to the buyer via the “Order dispatched” email.
You can find the tracking URL after the order is in SHIPPED status in: order.statusHistory[status="SHIPPED"].eventData.trackingUrl

​
Update Frequency

Tracking updates happen every 2 hours. Update your scheduling mechanisms to check the API every 2 hours or more. Querying the API in periods smaller than 2 hours is not recommended because you will not get anything new.

Update Parcel Trackings

Next: Learn how to send tracking events from fulfillment