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": [
{
"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
Filter only parcels created on or after the specified date and time, in ISO 8601 format, inclusive. Example: 2025-09-01T00:00:00Z.
Filter only parcels created on or before the specified date and time, in ISO 8601 format, inclusive. Example: 2025-09-30T23:59:59Z.
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.
Filter only parcels last updated on or before the specified date and time, in ISO 8601 format, inclusive. Example: 2025-09-06T17:14:53Z.
Filter by parcel status. Can be one of: SHIPMENT_CREATED, SHIPPED, ARRIVED_DESTINATION_COUNTRY, CUSTOMS_CLEARANCE, LAST_MILE, DELIVERED, SHIPMENT_CANCELED.
Filter by sales channel identifier.
Filter by order identifier in the sales channel.
Filter by last mile tracking number, i.e. the logistics provider’s tracking number.
Filter by tracking number, i.e. e-CROSS’ parcel ID.
Filter by customer document.
Comma-separated list of parcel IDs to filter.
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. Filter by shipment identifier.
Response Fields
Array of parcel objects matching the specified filters. Each parcel has the same structure as the response from Get parcel details. 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. 