Delibari API · developer portalAn API API we'd actually want to use.
Clean REST, typed SDKs, honest webhooks, and docs written by the people who built the endpoints. No sales pitch in the docs, no paywalled reference.
POST · /v1/shipmentsprivate beta · v0.9.2
# Create a shipment. That's it. curl https://api.delibari.co/v1/shipments \ -H "Authorization: Bearer sk_live_•••" \ -H "Idempotency-Key: ord_00481" \ -d '{ "to": { "name": "Delphine Roux", "city": "Paris", "country": "FR" }, "parcel": { "weight_g": 620, "dims_cm": [24, 18, 6] }, "service": "auto" }' # Response · 201 Created { "id": "shp_2F8a…zLQ", "carrier": "chronopost", "service": "express", "label_url": "https://…/label.pdf", "tracking_url": "https://ship.yourbrand.com/…", "price_cents": 742, "eta": "2026-04-26T11:00:00Z" }
一The stack
What you'll find under the hood.
The API powers our own products first: we write the endpoints we use in production.
- Plans
- REST API and webhooks included in Kiwa and Mugen
- Protocol
- REST and JSON
- Webhooks
- Signed, replayable for 7 days
- Reliability
- Idempotency keys on every write
- SDK
- TypeScript, Python, PHP, Ruby
- Rate limits
- 1,000 requests per minute by default, lifted on request. We'll tell you before we throttle you.
- Hosting
- Paris and Frankfurt, two AWS regions, active-active. No data leaves the EU without your say-so.
- Uptime
- 99.98% over the last 90 days, planned maintenance included, published on our status page
二Example
One shipment, one label, six lines.
With optimize: "cost", Delibari compares the services available on the route and buys the cheapest one that matches your rules. The label, tracking and customs invoice come back in the same response.
Replace "cost" with "speed" or let "auto" apply your account's rules.
ship.jsTypeScript SDK
// Create a shipment at the best rate const shipment = await delibari.shipments.create({ from: "paris-fr", to: "brooklyn-ny-us", parcel: { weight: 1.2, dims: [30, 20, 12] }, optimize: "cost", }); const label = await shipment.purchase(); console.log(label.tracking); // → DLB_3f8a… · €6.40 saved
繋MCP server
For your agents, not just your developers.
Delibari's MCP server (Model Context Protocol) gives your AI agents the same capabilities as the API: Dots, Hermes, Claude Cowork or any MCP-compatible client. Your agent runs logistics in plain language, without a single line of integration code.
- Tools
- Compare rates, create a shipment, track a parcel, open a claim, approve a return, reply to a customer
- Permissions
- The same roles as the dashboard. You choose what the agent can do on its own and what needs approval.
- Audit trail
- Every agent action is logged and visible in the dashboard
- Compatibility
- Any MCP client: Dots, Hermes, Claude Cowork…
三Roadmap
Built in public.
We'd rather tell you what's cooking than put a date on everything. When a date slips, we'll say so.
- Alpha
Core REST
Shipments, rates, tracking. Authenticated, idempotent endpoints, tested in production with eleven partner brands.
- Q2 2026
Webhooks and event log
Signed deliveries, replayable for 7 days. Filterable event log in the dashboard.
- Q3 2026
Public beta and SDKs
Open sign-ups, typed SDKs for TypeScript, Python, PHP and Ruby. Free under 500 labels a month.
- Q4 2026
White-label portal
Customer-facing tracking API, returns portal, custom domains: the whole post-purchase surface.
四Delibari Nexus · logistics partners
Resell our rates. Run your own platform.
For 3PLs, fulfilment houses, marketplaces and platforms: plug your customers into the same carriers and rails as Delibari, under your brand, your pricing, your contract. Available from the Kiwa plan.
Wholesale rates
Our negotiated contracts with more than 40 carriers (EU, US, Malaysia, Singapore, China), resold at wholesale. The margin is yours: 5 to 22% below direct rates.
Shared network
Our carrier integrations become yours: one connection, every service, from economy to express.
White label
Ship from our API under your brand. Tracking on your domain, a returns portal with your logo. Your customers never see Delibari.
Revenue share
Transparent take rate, weekly settlement, 30-day exit with no penalty.
五Demo
Pick a time. We'll show you the whole platform.
30 minutes with the team: an audit of your carriers and rates, a demo on your own routes, and an estimate of what shipping costs you today.
- sales@delibari.coSales · reply in under 30 minutes
- help@delibari.coCustomers · 24/7 on-call
- press@delibari.coPress and partnerships
Ship with
Delibari.