Skip to main content

​
Overview

Retrieve detailed information about a shipment by its ID. Use this endpoint to check the status and details of shipments you’ve created.

​
Get Shipment

Retrieve a shipment by its ID. 
curl -X GET 'https://hermes.api.e-cross.tech/ext/shipments/aa65bd71-33cf-40c1-bdc5-91b01344f659' \
  -H 'Authorization: Bearer YOUR_TOKEN'

{
  "id": "aa65bd71-33cf-40c1-bdc5-91b01344f659",
  "description": "Weekly dispatch",
  "status": "CREATED",
  "creationDate": "2025-06-10T10:43:59.080Z",
  "lastUpdateDate": "2025-06-10T10:43:59.080Z",
  "parcelIds": [
    "PURECAPS387294640090BR"
  ],
  "merchantId": "PURECAPS",
  "expectedShipDate": "2025-06-01T15:00:00Z",
  "expectedDeliveryDate": "2025-06-03T15:00:00Z",
  "firstMileCarrierId": "USPS",
  "firstMileTrackingNumber": "FM123456",
  "weight": 0.24
}

​
Path Parameters

​
shipmentId
string
required
Unique identifier of the shipment. This is the id returned when creating the shipment.

​
Response Fields

​
id
string
required
Unique identifier of this shipment.
​
status
string
required
Status of the shipment. Can be one of:
  • CREATED - Shipment has been created
  • SHIPPED - Shipment has been shipped
  • CANCELLED - Shipment was cancelled
​
parcelIds
array
required
Array containing the parcel IDs contained in this shipment.
​
description
string
required
Human-readable description of the dispatch.
​
expectedShipDate
string
required
Expected date and time when the package will leave the fulfillment facility.
​
expectedDeliveryDate
string
required
Expected date and time when the package will arrive at the consolidation hub.
​
firstMileCarrierId
string
required
Identifier of the first mile carrier company.
​
firstMileTrackingNumber
string
required
Tracking number or code of the first mile dispatch.
​
weight
number
required
Total weight of the shipment in kilograms, generated by summing the weight of all parcels.
​
merchantId
string
required
The merchant ID.
​
creationDate
string
required
Date and time when the shipment was created.
​
lastUpdateDate
string
required
Date and time when the shipment was last updated.
Use this endpoint to track the status of your shipments and verify which parcels are included in each shipment.

Get Parcel Details

Next: Learn how to track parcel status and events