Get parcel details

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": [
    {
      "countryOfOrigin": "Spain",
      "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"
    }
  ]
}

For a known order, start with Get order by ID or Get order by sales channel order ID and inspect order.shipping.deliveries[].parcels[]. Use this endpoint when your workflow already has a parcelId or needs a parcel-focused response.

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": [
    {
      "countryOfOrigin": "Spain",
      "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

string

required

Parcel identifier. You can retrieve it from order.shipping.deliveries[].parcels[].parcelId after the order reaches READY_TO_SHIP.

Response Fields

string

Identifier of the merchant.

string

Identifier of the parcel.

string

Identifier of the sales channel where the order was placed.

string

Identifier of the order in the sales channel.

string

Country where the parcel was dispatched from.

string

Country where the parcel will be delivered to.

string

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

string

Public tracking link sent to the buyer. This URL renders a web application to display trackings.

string

Identifier of the shipment in which the parcel is included, if any.

number

Estimated weight of the parcel in kg including packaging.

number

Estimated weight of the parcel in kg without packaging.

number

Estimated volumetric weight of the parcel in kg.

string

Tracking number of the parcel in the last mile provider.

string

Date when the parcel was created.

string

Date of the estimated delivery of the parcel.

string

Date of the last update of the parcel.

string

URL of the commercial invoice.

string

Number of the commercial invoice.

array

Array of labels associated with the parcel.

Show Label Fields

string

Public URL of the label.

string

Type of service this label refers to.

string

Parcel code in the respective logistics provider.

array

Array of items included in the parcel.

Show Item Fields

string

required

Country where the SKU was manufactured. The parcel preserves the country name stored for the item.

string

HS code of the item.

number

Weight of the item in kg.

string

Identifier of the product.

integer

Quantity of the item.

string

Identifier of the SKU.

string

Name of the SKU.

array

Array of logistics events associated with the parcel.

Show Event Fields

string

Description of the event.

string

Date when the event occurred.

string

Date when the event was received by e-CROSS.

object

When a tracking is successfully mapped to e-CROSS trackings.

Show Core Status Fields

string

Code of the step displayed in the public tracking link.

string

Internal code of the event.

string

Macro step of the event (same domain as status field).

Overview

Authentication APIs

Sales Channel APIs

Merchant Catalog APIs

Order APIs

Shipment APIs

Parcel APIs

Sandbox APIs

Path Parameters

Response Fields

​Path Parameters

​Response Fields

Path Parameters

Response Fields