List parcels

curl -X GET 'https://hermes.api.e-cross.tech/ext/parcels?creationDateFrom=2025-09-01T00:00:00Z&creationDateUntil=2025-09-30T23:59:59Z' \
  -H 'Authorization: Bearer YOUR_TOKEN'

{
  "parcels": [
    {
      "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"
        }
      ]
    }
  ],
  "nextPageToken": "eyJjcmVhdGlvbkRhdGUiOiIyMDI1LTA5LTI1VDE4OjA3OjAzLjcwM1oiLCJwYXJjZWxJZCI6Ik1FUkNIQU5UOTE4MzQwOTgxMTA3TVgiLCJ0eXBlIjoicGFyY2VsIn0="
}

For a known order, start with the order APIs and inspect order.shipping.deliveries[].parcels[]. Use this endpoint when you need parcel-level search or filtering across many orders.

curl -X GET 'https://hermes.api.e-cross.tech/ext/parcels?creationDateFrom=2025-09-01T00:00:00Z&creationDateUntil=2025-09-30T23:59:59Z' \
  -H 'Authorization: Bearer YOUR_TOKEN'

{
  "parcels": [
    {
      "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"
        }
      ]
    }
  ],
  "nextPageToken": "eyJjcmVhdGlvbkRhdGUiOiIyMDI1LTA5LTI1VDE4OjA3OjAzLjcwM1oiLCJwYXJjZWxJZCI6Ik1FUkNIQU5UOTE4MzQwOTgxMTA3TVgiLCJ0eXBlIjoicGFyY2VsIn0="
}

Query Parameters

string

Filter only parcels created on or after the specified date and time, in ISO 8601 format, inclusive. Example: 2025-09-01T00:00:00Z.

string

Filter only parcels created on or before the specified date and time, in ISO 8601 format, inclusive. Example: 2025-09-30T23:59:59Z.

string

Filter only parcels last updated on or after the specified date and time, in ISO 8601 format, inclusive. Example: 2025-09-06T17:14:53Z. Must be less than or equal to lastUpdateDateUntil when both are provided.

string

Filter only parcels last updated on or before the specified date and time, in ISO 8601 format, inclusive. Example: 2025-09-06T17:14:53Z.

string

Filter by parcel status. Can be one of: SHIPMENT_CREATED, SHIPPED, ARRIVED_DESTINATION_COUNTRY, CUSTOMS_CLEARANCE, LAST_MILE, DELIVERED, SHIPMENT_CANCELED.

string

Filter by sales channel identifier.

string

Filter by order identifier in the sales channel.

string

Filter by last mile tracking number, i.e. the logistics provider’s tracking number.

string

Filter by tracking number, i.e. e-CROSS’ parcel ID.

string

Filter by customer document.

string

Comma-separated list of parcel IDs to filter.

string

The token to fetch the next page of results. Use the value returned in the nextPageToken field of the previous response. See Pagination for details.

string

Filter by shipment identifier.

Response Fields

array

Array of parcel objects matching the specified filters. Each parcel has the same structure as the response from Get parcel details.

string

The token to be used in the query parameter to retrieve the next page of results. If there are no more results, this field won’t be returned. See Pagination for usage.

Overview

Authentication APIs

Sales Channel APIs

Merchant Catalog APIs

Order APIs

Shipment APIs

Parcel APIs

Sandbox APIs

Query Parameters

Response Fields

​Query Parameters

​Response Fields

Query Parameters

Response Fields