Retrieving tracking data

Retrieving tracking information for shipments

With the exporto API, technical integration partners can retrieve the processing status of individual shipments. This information provides details on:

• whether a shipment has already been processed by exporto,
• whether it has been successfully cleared through customs,
• and the current status of delivery by the last-mile carrier.
   

Recommended procedure for retrieving tracking data

There are two ways to retrieve tracking information:

• Direct retrieval of individual shipments by shipmentID
• Retrieval of processed shipments via tours (recommended for larger shipment volumes)
   

1. Direct retrieval of individual shipments

If the shipmentID is known, the current status can be queried directly via the following endpoint:

GET /shipment/{shipmentId}

The API response contains, among other things, the following status information and timestamps that map the shipment's processing chain:

{
  "processedAt": "2025-04-03T10:32:31.329Z",
  "declaredAt": "2025-04-03T10:32:31.329Z",
  "carrierState": "notAvailable",
  "carrierReceivedAt": "2025-04-03T10:32:31.329Z",
  "carrierDeliveredAt": "2025-04-05T15:45:12.000Z"
}

These values provide information about when a shipment was processed, cleared through customs, handed over to the carrier, or delivered.

2. Retrieving processed shipments via tours

If you need to check the status of multiple shipments on a regular basis, exporto recommends retrieving them via tours.

Step 1: Retrieve list of available tours

In exporto, a tour corresponds to an internal daily closing. A list of available tourIDs can be retrieved via the following endpoint:

GET /tours

Step 2: Retrieve shipmentIDs within a tour

The tourIDs received can be used to determine which shipments belong to a specific tour:

GET /tour/{tourId}

The response contains all shipmentIDs that belong to this tour.
 

Step 3: Retrieve detailed information on individual shipments

For each shipmentID received, the tracking information can then be retrieved individually via the known endpoint:

GET /shipment/{shipmentId}

Note

By using the tour-based retrieval, only those shipments that have already been processed can be efficiently queried. This reduces unnecessary API requests for shipments that have not yet been completed.

Contact

The exporto team is available to answer any technical questions or provide support with implementation.

Contact: product@exporto.de