Maxmove for Developers
Build delivery into your product
A REST API to quote, create, and track same-day deliveries — with signed webhooks, idempotent requests, a test-mode simulator, and carrier-side fleet order ingestion.
Quote → create → track
Price a route, create a delivery from a quote or inline, and follow the courier with ETA and live position.
Signed webhooks
HMAC-signed events for every status change, with retries, DLQ, and replay. Verify with your endpoint secret.
Test mode
mm_test_ keys run a Robocourier simulator through the full lifecycle — integrate end to end before going live.
Fleet ingestion
Fleet keys push orders from your customers’ systems straight into your dispatch board.
Authentication
Authenticate with an organization-scoped API key in the x-api-key header. Live keys (mm_live_) create real orders; test keys (mm_test_) create simulated deliveries that never dispatch a courier. Issue and revoke keys from your Maxmove dashboard, scoped to exactly the resources you need.
Quickstart
Discover a vehicle type, quote a route, create the delivery with an Idempotency-Key, then poll tracking. Replace the key and quote id with your own.
# 1. Discover vehicle types
curl https://api.maxmove.com/partner/v1/vehicle-types \
-H "x-api-key: $MAXMOVE_KEY"
# 2. Quote a route
curl -X POST https://api.maxmove.com/partner/v1/quotes \
-H "x-api-key: $MAXMOVE_KEY" -H 'content-type: application/json' \
-d '{
"pickup": { "address": "Ehrenstraße 15, Köln", "latitude": 50.9385, "longitude": 6.9469 },
"dropoff": { "address": "Königsallee 27, Düsseldorf", "latitude": 51.2233, "longitude": 6.7768 },
"vehicle_type_id": "courier"
}'
# 3. Create the delivery (retry-safe via Idempotency-Key)
curl -X POST https://api.maxmove.com/partner/v1/deliveries \
-H "x-api-key: $MAXMOVE_KEY" -H 'content-type: application/json' \
-H 'Idempotency-Key: order-4711' \
-d '{ "quote_id": "qt_…", "external_id": "order-4711",
"contact": { "name": "Erika Muster", "phone": "+49 170 0000000" } }'
# 4. Track until delivered
curl https://api.maxmove.com/partner/v1/deliveries/del_…/tracking \
-H "x-api-key: $MAXMOVE_KEY"Endpoints
| POST | /partner/v1/quotes | Quote a route (valid 5 minutes) |
| POST | /partner/v1/deliveries | Create a delivery from a quote or full route |
| GET | /partner/v1/deliveries/{id}/tracking | Live tracking: ETA, courier position, polyline |
| POST | /partner/v1/deliveries/{id}/cancel | Cancel before the courier picks up |
| GET | /partner/v1/deliveries/{id}/proof-of-delivery | Proof of delivery (signatures, photos) |
| POST | /partner/v1/webhooks | Register a webhook endpoint |
| POST | /partner/v1/fleet/orders | Push an order into your fleet dispatch board |