Skip to Content
API ReferenceOverview

Overview

The Partner API v2026-04 is a small JSON/HTTPS API with two capabilities:

  • Pull — read the tracking history of a shipment on demand.
  • Push — receive a signed HTTP notification whenever a shipment you follow changes status.

Base URL

https://delivery.spedisci.online/api/v2026-04/

The OAuth token endpoint is outside this prefix:

https://delivery.spedisci.online/oauth/token

Conventions

TopicRule
TransportHTTPS only
FormatJSON request and response bodies
AuthAuthorization: Bearer <access_token> on every /api/v2026-04/* request
Shipment numberThe ldv, exactly 12 characters, case-insensitive (normalised to uppercase)
Lookup windowShipments are searchable for 90 days after creation
TimestampsISO-8601 (e.g. 2026-04-18T14:32:05+00:00)

An ldv is always stored and returned in uppercase. You may send it lowercase — the API uppercases it for you, both on lookup and on subscription.

Error Envelope

Errors return a consistent JSON object:

{
  "code": 404,
  "status": "error",
  "message": "Shipment not found!"
}

Validation errors are the one exception — they follow Laravel’s standard 422 format:

{
  "message": "The given data was invalid.",
  "errors": {
    "url": ["The url format is invalid."]
  }
}

See Errors for the complete list.

Rate Limits and Retention

RuleValue
Shipment lookup window90 days from shipment creation
Subscription retentionDeleted 30 days after the shipment is delivered (status 5)
Notification attempts5 attempts per notification
Webhook auto-disableAfter 10 consecutive failed notifications

A subscription is automatically removed 30 days after delivery. If you subscribe to an already delivered shipment you may never receive a notification — the status has to change for one to fire. Use GET /tracking/{ldv} for the current state.

Last updated on
HomeAuthentication