Smoover / Developers
For developers and AI agents

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.

Authentication

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.

Required header
Content-Type: application/json

Errors

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.

400INVALIDMissing or invalid field, or the body is not valid JSON.
403Browser request from another website.
415The body is not JSON.
422LOCATIONAn address could not be matched clearly. Ask for a more precise city, postcode or street.
422COUNTRYCountry not supported, or the code does not match the address.
422ROUTENo suitable truck route found.
429RATE_LIMITToo many requests from your IP. Wait a minute.
503UNAVAILABLEThe service is busy or has used its daily allowance for new routes. Try again later and never show a guessed price.
Error response
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 minute

    About 15 requests per minute to /api/estimate and /mcp.

  • New routesper minute and day

    3 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 clients

    When all clients together have used today’s allowance for new routes, requests return 503 until midnight UTC.

Need more for a comparison site or a partner integration? Get in touch.

Rate limit response
HTTP/1.1 429 Too Many Requests

{ "error": "RATE_LIMIT" }
Estimates

The estimate object

Returned by POST /api/estimate and, as structuredContent, by the MCP tool get_moving_estimate.

  • low, highnumber

    Price range in EUR, including VAT at vatRate.

  • vatRatenumber

    VAT applied, for example 0.19 for 19 %. 19 % when Germany is the start or destination; other EU moves use the rate of the start country.

  • estimateType, bindingstring, boolean

    Always "rough" and false. The result is an estimate, not an offer.

  • distanceKmnumber

    Road distance of the truck route.

  • fleetarray

    Vehicles used, each with name and quantity.

  • crewinteger

    Number of movers.

  • loadHours, unloadHoursnumber

    Planned working time at the start and at the destination.

  • ferryboolean

    true when the route needs a ferry or train crossing. Its fare is not included.

  • origin, destinationstring

    The places as we matched them. Show them to the user so a wrong match is easy to spot.

  • fixedPriceQuoteUrlstring

    Smoover request form with the route filled in. Give it to the user. Never submit it for them.

  • versionstring

    Version of the calculation. Useful when you report a problem.

The estimate object
{
  "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
}
Estimates

Create an estimate

POST/api/estimate

Calculates 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

  • originstringRequired

    Start city, postcode or street address, 2 to 250 characters. A street address gives the most exact route.

  • originCountrystringRequired

    ISO 3166-1 alpha-2 code of the start, for example DE. EU countries, CH and GB.

  • destinationstringRequired

    Destination city, postcode or street address.

  • destinationCountrystringRequired

    ISO code of the destination.

  • volumenumberRequired

    Volume in m³, from 1 to 200. See move sizes.

  • languagestring

    en (default) or de. Language of the place names and of the quote form.

Returns

An estimate object, or an error.

POST /api/estimate
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
  }'
Response
{
  "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
}
MCP server

Connect a client

POST/mcp

The 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 Code
claude mcp add --transport http smoover https://api.smoover-moving.de/mcp
Cursor · ~/.cursor/mcp.json
{
  "mcpServers": {
    "smoover": { "url": "https://api.smoover-moving.de/mcp" }
  }
}
VS Code · .vscode/mcp.json
{
  "servers": {
    "smoover": { "type": "http", "url": "https://api.smoover-moving.de/mcp" }
  }
}
MCP server

get_moving_estimate

TOOLget_moving_estimate

Live price range for a route and volume. Same calculation, cache and limits as Create an estimate. Read-only.

Arguments

  • originstringRequired

    Start city, postcode or street address.

  • origin_countrystringRequired

    ISO code of the start.

  • destinationstringRequired

    Destination city, postcode or street address.

  • destination_countrystringRequired

    ISO code of the destination.

  • volume_m3numberRequired

    Volume in m³, from 1 to 200.

  • languagestring

    en (default) or de.

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.

Tool call
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
    }
  }
}
Result
{
  "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"
    }
  }
}
MCP server

get_move_sizes

TOOLget_move_sizes

Typical volumes per home size, so the assistant can help the user pick volume_m3. No arguments, no external lookup, no limit.

SizeVolumeTypical home
Mini5 m³A room or a few pieces of furniture
Small10 m³Furnished studio
Medium15 m³1-bedroom flat
Large25 m³2–3 bedroom flat
Very large50 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.

structuredContent (shortened)
{
  "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" }
  ]
}
Discovery

OpenAPI description

GET/openapi.json

OpenAPI 3.1 description of POST /api/estimate. Use it for custom GPT actions, code generators or API clients.

Request
curl https://api.smoover-moving.de/openapi.json
Discovery

llms.txt

GET/llms.txt

A short plain-text summary for language models: what Smoover does, where the API and MCP server are, and how to present results.

Response (start)
# 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/estimate
Discovery

MCP discovery file

GET/.well-known/mcp.json

Lets MCP clients and directories find the server, its transport and its tools without connecting first.

Response (shortened)
{
  "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": "…" }
  ]
}
Guides

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.

  1. Route. We plan the road route with a truck profile for each vehicle type, including tolls at their real cost.
  2. 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³.
  3. 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.
  4. Borders. Moves across a non-EU border (Switzerland, United Kingdom) include a customs fee, and UK moves an entry fee per vehicle.
  5. 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.

Example: Munich → Barcelona, 15 m³
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. VAT
Guides

Presenting results

For assistants and apps that show the estimate to a person:

  1. Ask for start, destination with country and the size of the home if the user did not say. Never invent an address.
  2. Show the price as a range and say that it is an estimate for standard conditions.
  3. Repeat the matched origin and destination so the user can correct a wrong match.
  4. Offer the fixedPriceQuoteUrl for a binding fixed price. The user sends the form themselves.
  5. On an error or 503, say so and offer the quote form. Never make up a price.
Example answer
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?…
Guides

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.