📘 Introduction
MyDello Customer API uses REST API architecture with JSON encoding, authenticates via Basic Auth, and returns standard HTTP response codes. All communication is secured using HTTPS protocol.
Request QuotesGet instant shipping solutions by providing origin, destination, weight, and volume
View InquiriesAccess detailed information about your existing inquiries and available solutions
Book ShipmentsOrder shipments and upload required documentation seamlessly
Track OrdersMonitor shipment details and download related documents
🔑 Get Access Credentials
Customer API access must be granted by MyDello. All integration work starts in the Sandbox environment — production access is enabled only after your integration is complete and reviewed by MyDello.
How it works:
- Contact our support team to request access.
- We provision your Sandbox credentials. Create your API user and retrieve them in the portal: Settings → API Settings.
- Build and test your integration entirely against the Sandbox environment.
- When your integration is complete, MyDello reviews the results together with you.
- Once reviewed and approved, we enable Customer API access in Production.
⚠️ Develop in Sandbox only: Never build or test your integration against the live Production environment. All development must be done in Sandbox; Production is enabled only after MyDello has reviewed your integration.
⚠️ Important: API credentials are shown only once in the portal. Store them securely. Lost credentials cannot be recovered and must be regenerated.
🔐 Authentication
The Customer API uses HTTP Basic Authentication. Include your credentials with every request:
- Username: Your API user SID
- Password: Your access token
⏱️ Rate Limits
Rate limits protect against API abuse and help manage infrastructure load:
- 100 requests per minute under normal usage
- 20 additional request slots freed every minute
- Exceeding limits returns 429 Too Many Requests
📝 Changelog
Version 1.2.1 (August 13, 2026)
- Added responsibleOperationsPerson to Shipment responses — the MyDello logistics specialist responsible for the shipment (first name, last name, email, phone and profile photo link), the same contact shown as "Your logistics specialist" in the MyDello portal. The object is null until a responsible person has been assigned.
Version 1.2.0 (July 24, 2026)
- Documented trackingDetails.events on Shipment responses — the shipment's tracking timeline of completed and upcoming milestones, with gateway and location detail. See the "Tracking timeline" section under GET /customer-api/shipment/{id}.
Version 1.1.1 (June 19, 2026)
- Added referenceIdFormatted to Inquiry and Shipment responses — the human-readable identifier shown in the MyDello portal (e.g. I123456EU for Inquiry, S123456EU for Shipment), encoding object type, referenceId, and region.
Version 1.1.0 (May 26, 2026)
- Added GET /customer-api/shipment — returns a paged list (50 shipments per page) of all shipments belonging to the logged-in user's company. Supports an optional isActive filter (true = currently under active delivery, false = delivered or cancelled, omitted = all shipments)
- GET /customer-api/shipment/{id} now accepts either the shipment id (GUID) or the shipment referenceId (integer)
Version 1.0.1 (August 22, 2025)
- Insurance policy cost and documentation fee are now calculated automatically when isFullInsuranceRequested is set to true and valuePerUnit and valueCurrencyCurrencyCodeIso values are provided with the Inquiry request
