Moving cost API
Price a household move anywhere in the EU, Switzerland and the UK. The API runs the same calculation as our own moving calculator: the real truck route with tolls, the vehicles the volume needs and the crew to load it. You get a price range in EUR including VAT and a link where the user can ask Smoover for a binding fixed price.
- FormatsJSON over HTTPS and an MCP server
- Accessfree, no API key
- Coverage27 EU countries, Switzerland, United Kingdom
- Side effectsnone. Requests never book anything.
https://api.smoover-moving.deAuthentication
There is no authentication. Send requests from your server, script or agent with Content-Type: application/json.
Calls from a visitor’s browser on another website are rejected with 403, so the API cannot be built into a public web page directly. Call it from your backend and pass the result on.
Content-Type: application/jsonErrors
Errors use standard HTTP status codes and a short JSON body with an error code. Show the user a clear message and, for the last three, offer the quote form instead of a price.
400 | INVALID | Missing or invalid field, or the body is not valid JSON. |
403 | Browser request from another website. | |
415 | The body is not JSON. | |
422 | LOCATION | An address could not be matched clearly. Ask for a more precise city, postcode or street. |
422 | COUNTRY | Country not supported, or the code does not match the address. |
422 | ROUTE | No suitable truck route found. |
429 | RATE_LIMIT | Too many requests from your IP. Wait a minute. |
503 | UNAVAILABLE | The service is busy or has used its daily allowance for new routes. Try again later and never show a guessed price. |
HTTP/1.1 422 Unprocessable Entity
{ "error": "LOCATION" }Rate limits
The API is free, and every new route costs us a lookup. These limits apply per IP address:
Requestsper minuteAbout 15 requests per minute to
/api/estimateand/mcp.New routesper minute and day3 per minute and 20 per day. A route calculated in the last 30 days comes from the cache and does not count, so changing only the volume is free.
Daily allowanceall clientsWhen all clients together have used today’s allowance for new routes, requests return
503until midnight UTC.
Need more for a comparison site or a partner integration? Get in touch.
HTTP/1.1 429 Too Many Requests
{ "error": "RATE_LIMIT" }The estimate object
Returned by POST /api/estimate and, as structuredContent, by the MCP tool get_moving_estimate.
low, highnumberPrice range in EUR, including VAT at
vatRate.vatRatenumberVAT applied, for example
0.19for 19 %. 19 % when Germany is the start or destination; other EU moves use the rate of the start country.estimateType, bindingstring, booleanAlways
"rough"andfalse. The result is an estimate, not an offer.distanceKmnumberRoad distance of the truck route.
fleetarrayVehicles used, each with
nameandquantity.crewintegerNumber of movers.
loadHours, unloadHoursnumberPlanned working time at the start and at the destination.
ferrybooleantruewhen the route needs a ferry or train crossing. Its fare is not included.origin, destinationstringThe places as we matched them. Show them to the user so a wrong match is easy to spot.
fixedPriceQuoteUrlstringSmoover request form with the route filled in. Give it to the user. Never submit it for them.
versionstringVersion of the calculation. Useful when you report a problem.
{
"currency": "EUR",
"estimateType": "rough",
"binding": false,
"low": 4188.8,
"high": 6033.3,
"vatRate": 0.19,
"distanceKm": 1426,
"crew": 2,
"loadHours": 3.75,
"unloadHours": 2.5,
"fleet": [{ "name": "7.5t Truck", "quantity": 1 }],
"ferry": false,
"origin": "Munich, Germany",
"originCountry": "DE",
"destination": "Barcelona, Spain",
"destinationCountry": "ES",
"volume": 15,
"fixedPriceQuoteUrl": "https://portal.smoover-moving.de/request_new?from=Munich%2C+Germany&to=Barcelona%2C+Spain&lang=en_us&utm_source=smoover-moving.de&utm_medium=api",
"version": "public-2026-10-24.3",
"calculationMs": 2831
}Create an estimate
/api/estimateCalculates a price range for one route and volume. Takes about three seconds for a new route and is instant for a cached one.
Body parameters
originstringRequiredStart city, postcode or street address, 2 to 250 characters. A street address gives the most exact route.
originCountrystringRequiredISO 3166-1 alpha-2 code of the start, for example
DE. EU countries,CHandGB.destinationstringRequiredDestination city, postcode or street address.
destinationCountrystringRequiredISO code of the destination.
volumenumberRequiredVolume in m³, from 1 to 200. See move sizes.
languagestringen(default) orde. Language of the place names and of the quote form.
Returns
An estimate object, or an error.
curl -X POST https://api.smoover-moving.de/api/estimate \
-H "Content-Type: application/json" \
-d '{
"origin": "Munich",
"originCountry": "DE",
"destination": "Barcelona",
"destinationCountry": "ES",
"volume": 15
}'const res = await fetch("https://api.smoover-moving.de/api/estimate", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
origin: "Munich",
originCountry: "DE",
destination: "Barcelona",
destinationCountry: "ES",
volume: 15,
}),
});
const estimate = await res.json();import requests
res = requests.post("https://api.smoover-moving.de/api/estimate", json={
"origin": "Munich",
"originCountry": "DE",
"destination": "Barcelona",
"destinationCountry": "ES",
"volume": 15,
})
estimate = res.json(){
"currency": "EUR",
"estimateType": "rough",
"binding": false,
"low": 4188.8,
"high": 6033.3,
"vatRate": 0.19,
"distanceKm": 1426,
"crew": 2,
"loadHours": 3.75,
"unloadHours": 2.5,
"fleet": [{ "name": "7.5t Truck", "quantity": 1 }],
"ferry": false,
"origin": "Munich, Germany",
"originCountry": "DE",
"destination": "Barcelona, Spain",
"destinationCountry": "ES",
"volume": 15,
"fixedPriceQuoteUrl": "https://portal.smoover-moving.de/request_new?from=Munich%2C+Germany&to=Barcelona%2C+Spain&lang=en_us&utm_source=smoover-moving.de&utm_medium=api",
"version": "public-2026-10-24.3",
"calculationMs": 2831
}Connect a client
/mcpThe MCP server uses Streamable HTTP and needs no login. Once it is connected, an assistant can answer “What would it cost to move my two-bedroom flat from Berlin to Amsterdam?” with a live price.
Claude
In Claude on the web or desktop, open Settings → Connectors → Add custom connector and paste https://api.smoover-moving.de/mcp. In Claude Code, run the command on the right.
ChatGPT
With developer mode on, add a connector under Settings → Apps & Connectors and paste the URL. For a custom GPT, import https://api.smoover-moving.de/openapi.json as an action instead.
Cursor and VS Code
Add the server to the MCP config file shown on the right.
claude mcp add --transport http smoover https://api.smoover-moving.de/mcp{
"mcpServers": {
"smoover": { "url": "https://api.smoover-moving.de/mcp" }
}
}{
"servers": {
"smoover": { "type": "http", "url": "https://api.smoover-moving.de/mcp" }
}
}get_moving_estimate
get_moving_estimateLive price range for a route and volume. Same calculation, cache and limits as Create an estimate. Read-only.
Arguments
originstringRequiredStart city, postcode or street address.
origin_countrystringRequiredISO code of the start.
destinationstringRequiredDestination city, postcode or street address.
destination_countrystringRequiredISO code of the destination.
volume_m3numberRequiredVolume in m³, from 1 to 200.
languagestringen(default) orde.
Returns
A short text for the model and the estimate object as structuredContent. Errors come back as a tool result with isError: true and a sentence telling the assistant what to do next.
POST https://api.smoover-moving.de/mcp
Content-Type: application/json
Accept: application/json, text/event-stream
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "get_moving_estimate",
"arguments": {
"origin": "Munich",
"origin_country": "DE",
"destination": "Barcelona",
"destination_country": "ES",
"volume_m3": 15
}
}
}{
"jsonrpc": "2.0",
"id": 1,
"result": {
"content": [{ "type": "text", "text": "Munich → Barcelona, 15 m³: about €4,189 – €6,033 incl. VAT …" }],
"structuredContent": {
"low": 4188.8,
"high": 6033.3,
"currency": "EUR",
"distanceKm": 1426,
"fixedPriceQuoteUrl": "https://portal.smoover-moving.de/request_new?…",
"…": "same fields as the estimate object"
}
}
}get_move_sizes
get_move_sizesTypical volumes per home size, so the assistant can help the user pick volume_m3. No arguments, no external lookup, no limit.
| Size | Volume | Typical home |
|---|---|---|
| Mini | 5 m³ | A room or a few pieces of furniture |
| Small | 10 m³ | Furnished studio |
| Medium | 15 m³ | 1-bedroom flat |
| Large | 25 m³ | 2–3 bedroom flat |
| Very large | 50 m³ | House with garage or cellar |
Rule of thumb: about 5 m³ per furnished room plus kitchen and cellar. When in doubt, take the next size up.
{
"sizes": [
{ "key": "mini", "name": "Mini", "volume": 5, "home": "A room or a few pieces of furniture" },
{ "key": "small", "name": "Small", "volume": 10, "home": "Studio flat" },
{ "key": "medium", "name": "Medium", "volume": 15, "home": "1-bedroom flat" },
{ "key": "large", "name": "Large", "volume": 25, "home": "2–3 bedroom flat" },
{ "key": "xlarge", "name": "Very large", "volume": 50, "home": "House" }
]
}OpenAPI description
/openapi.jsonOpenAPI 3.1 description of POST /api/estimate. Use it for custom GPT actions, code generators or API clients.
curl https://api.smoover-moving.de/openapi.jsonllms.txt
/llms.txtA short plain-text summary for language models: what Smoover does, where the API and MCP server are, and how to present results.
# Smoover moving price API
> Smoover (https://smoover-moving.de) moves households within
> Germany and between EU countries, Switzerland and the UK.
## Live prices for agents
- MCP server (Streamable HTTP, no auth): https://api.smoover-moving.de/mcp
- JSON API: POST https://api.smoover-moving.de/api/estimateMCP discovery file
/.well-known/mcp.jsonLets MCP clients and directories find the server, its transport and its tools without connecting first.
{
"name": "smoover",
"transport": {
"type": "streamable-http",
"url": "https://api.smoover-moving.de/mcp"
},
"authentication": { "required": false },
"tools": [
{ "name": "get_moving_estimate", "description": "…" },
{ "name": "get_move_sizes", "description": "…" }
]
}How prices are calculated
The API uses the model behind the calculator on our website. It gives a fair first number; it does not replace a look at the inventory.
- Route. We plan the road route with a truck profile for each vehicle type, including tolls at their real cost.
- Vehicles. We pick the fewest vehicles that carry the volume and the weight (80 kg per m³): a 3.5 t van takes 17 m³, a 7.5 t truck 36 m³ and an 18 t truck 55 m³.
- Crew. One mover loads about 2 m³ and unloads about 3 m³ per hour. The team starts at two people and grows so that loading and unloading each take at most six hours.
- Borders. Moves across a non-EU border (Switzerland, United Kingdom) include a customs fee, and UK moves an entry fee per vehicle.
- Range and VAT. The range runs from 18 % below to 18 % above the calculated cost, rounded to 10 €, plus VAT.
Included
Vehicles with driver and fuel, tolls, the loading and unloading crew, customs and UK entry fees where they apply.
Not included
Packing, furniture assembly, no-parking zones, heavy items such as a piano or safe, ferry and train fares, upper floors without a lift and long carrying distances.
Route 1,426 km, tolls included
Vehicles 1 × 7.5 t truck
Crew 2 movers
Loading 3.75 h
Unloading 2.5 h
VAT 19 % (Germany is the start)
Estimate €4,189 – €6,033 incl. VATPresenting results
For assistants and apps that show the estimate to a person:
- Ask for start, destination with country and the size of the home if the user did not say. Never invent an address.
- Show the price as a range and say that it is an estimate for standard conditions.
- Repeat the matched
originanddestinationso the user can correct a wrong match. - Offer the
fixedPriceQuoteUrlfor a binding fixed price. The user sends the form themselves. - On an error or
503, say so and offer the quote form. Never make up a price.
Moving a one-bedroom flat (about 15 m³) from Munich
to Barcelona costs roughly €4,190 to €6,030 including
VAT. That is based on a 1,426 km truck route with one
7.5 t truck and two movers, assuming easy access at
both addresses.
For a binding fixed price, you can send your details
to Smoover here: https://portal.smoover-moving.de/request_new?…FAQ
Do I need an API key?
No. The JSON endpoint and the MCP server are open and free within the limits on this page. There is no sign-up.
Is the price binding?
No. The API returns a rough estimate for standard conditions. A binding fixed price comes from Smoover after we have seen the inventory and the access at both addresses. Every response contains a fixedPriceQuoteUrl that opens that request form with the route filled in.
Which countries are covered?
All 27 EU countries, Switzerland and the United Kingdom, in any combination, including moves within one country. The country code has to match the address you send.
Does a request create a booking or send data to Smoover?
No. The API is read-only. Nothing is booked and nobody is contacted. Smoover only hears from the user if they open the quote link and send the form themselves.
Can I use the API in my own website, app or agent?
Yes, as long as you show the result as an estimate and offer the fixedPriceQuoteUrl to the user. If you need more than the limits allow, or want a partner integration, write to us via the contact page.
Why do I get a range and not one price?
The calculation assumes standard conditions: ground floor or lift, short carrying distances, no packing or furniture assembly. Real moves differ, so the range shows where most moves of this size on this route end up.
What do you store about requests?
Request counters are stored per salted hash of the IP address, never the IP itself. Address lookups and truck routes are cached for up to 30 days so the same route does not need a new lookup.
Moving yourself? Use the moving calculator or ask Smoover for a fixed-price quote.