Coverage
How Maxmove decides whether a route is inside its service area, where it operates today, and how the API reports routes it can't serve.
Maxmove serves defined service areas. Whether a route can be booked is decided per request, so check it with a quote instead of keeping your own list of cities.
Where Maxmove operates#
Most orders are in North Rhine-Westphalia (NRW). Pickups are mainly in cities such as Cologne, Düsseldorf, Dortmund, Essen, Duisburg, Bochum, Wuppertal, Bonn, Münster, and Aachen. Coverage expands in phases. See Service availability and city coverage in the help center.
How a route is checked#
Maxmove keeps its service areas in a catalog that its operations team maintains. The catalog defines areas for pickups and for dropoffs, and exclusion zones. Changes to the catalog take effect without an API release.
For every quote and every delivery, Maxmove checks:
- the pickup,
- every stop,
- the dropoff.
If any of them is outside the service area, or inside an exclusion zone, the request answers 400 service_area_unavailable:
{
"error": {
"code": "service_area_unavailable",
"message": "The pickup, the dropoff, or a stop is outside the Maxmove service area."
},
"request_id": "7c9e6679-…"
}Check a route#
Request a quote with POST /v1/quotes. A quote changes nothing and isn't billed, so it is the simplest serviceability check. If the quote succeeds, the route was inside the service area at that moment. Maxmove checks the route again when you create the delivery.
In a shop checkout, hide or disable Maxmove delivery when the quote answers service_area_unavailable, and offer your other shipping methods.
Test mode#
Test keys use the same service area check as live keys, so an unserviceable route also fails in test mode.
Did this answer your question?