Shipments — List, Label & Cancel

Every shipment is identified by its tracking number (LDV), returned as trackingNumber when you create it.

List shipments

GET /shipments — paginated

curl "https://<subdomain>.spedisci.online/api/2026-09/shipments?from=2026-09-01&status=in_transit,out_for_delivery&per_page=100" \
  -H "Authorization: Bearer <access_token>" \
  -H "Accept: application/json"

The response is a paginated list of Shipment objects (without label).

Shipment detail

GET /shipments/{ldv}

Returns the Shipment object. 404 not_found when the LDV does not exist or belongs to another client.

Shipment object

Get the label

GET /shipments/{ldv}/label?format=pdf|zpl

Returns the label of an existing shipment in base64. Without format both formats are returned where available.

curl "https://<subdomain>.spedisci.online/api/2026-09/shipments/DEMO05407027/label?format=pdf" \
  -H "Authorization: Bearer <access_token>" \
  -H "Accept: application/json"

{
  "trackingNumber": "DEMO05407027",
  "format": "PDF",
  "pdf": "JVBERi0xLjcKMyAwIG9iago8PC9Ue...",
  "zpl": null
}

Cancel a shipment

DELETE /shipments/{ldv}

Cancels the shipment with the carrier and refunds the cost to the account credit. Possible only while the shipment is not yet in a manifest or in transit.

curl -X DELETE https://<subdomain>.spedisci.online/api/2026-09/shipments/DEMO05407027 \
  -H "Authorization: Bearer <access_token>" \
  -H "Accept: application/json"

{
  "trackingNumber": "DEMO05407027",
  "cancelled": true,
  "refunded": 7.0
}