Delivery Partner API

Welcome to the Delivery Partner API (version v2026-04). It lets an approved 3rd party partner query the tracking history of a shipment and receive push notifications whenever the status of a shipment they follow changes.

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

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

API Version: 2026-04

For support, contact supporto@spedisci.online.

Every endpoint below is protected by OAuth 2.0 client credentials. Read Authentication first — you need an access token before anything else works.

Getting Started

Authentication Get Tracking Manage Webhook Tracking Subscriptions Webhook Notifications Status Codes

Endpoint Overview

Method	Path	Description
`POST`	`/oauth/token`	Obtain an access token (client credentials)
`GET`	`/tracking/{ldv}`	Get the tracking detail of a shipment
`GET`	`/webhook`	Show the registered webhook
`POST`	`/webhook`	Register a webhook (returns the signing secret once)
`DELETE`	`/webhook`	Delete the webhook and all its subscriptions
`GET`	`/webhook/subscriptions`	List the shipments you are subscribed to
`POST`	`/webhook/subscriptions`	Subscribe to a shipment
`DELETE`	`/webhook/subscriptions/{ldv}`	Unsubscribe from a shipment

The token endpoint lives at the domain root (/oauth/token), not under the /api/v2026-04/ prefix.

Typical Integration Flow

Get credentials — the Spedisci.online team issues you a client_id and client_secret.
Request an access token from /oauth/token using the client_credentials grant.
Register your webhook with POST /webhook and store the returned secret safely.
Subscribe each shipment you care about with POST /webhook/subscriptions.
Receive notifications on your endpoint every time the status of a subscribed shipment changes; verify the X-Signature header on each one.
Optionally poll GET /tracking/{ldv} whenever you need the current history on demand.

Glossary

Term	Meaning
`ldv`	Lettera di vettura — the shipment tracking number. Always 12 characters.
Webhook	Your HTTPS endpoint that receives notifications. One per partner.
Subscription	The link between your webhook and one shipment (`ldv`).