This public, read-only interface uses the same calculation engine as the Staenis website. It returns estimated material quantities, separate alternatives and a link to review the calculation on the website. No account or API key is required.
OpenAPI 3.1 specification · Version 1
GET https://www.staenis.com/api/calculator/v1/calculate?surfaceM2=27&thicknessMm=80&filling=screed&country=be&culture=nl-BE
Send these five required query parameters, once each. You may also send the optional includeTileAdhesive boolean. Do not send a request body, email, postal address, postcode, phone number, contact details or cookies. Requests with unknown or duplicate parameters are rejected.
| Parameter | Meaning |
|---|---|
surfaceM2 | Whole square metres, 1–5000. Do not silently round a customer's dimensions. |
thicknessMm | Whole millimetres, 1–2000. The chosen material's narrower limits are checked by the calculator. For dry systems and system-only comparisons, exclude floor boards and finish. |
filling | One of the codes below. |
country | Recognized lowercase two-letter ISO country code, for example be. Material and system availability depends on country. Do not substitute Belgium for another country. |
culture | nl-BE, nl-NL, fr-BE, fr-FR, de-DE or en-150. Protocol keys and product names are English; validation and thermal labels follow this language. |
includeTileAdhesive (optional) | Defaults to true. For tileable insulation screed, includes Keraflex for bonding tiles as well as levelling. Set to false for levelling mortar only. Applies equally to the Strong and Cem Mini alternatives; other fillings are unchanged. The returned result link preserves this choice. |
screed: chape / screed (250 kg cement per m³).screed_plus_insulation_screed: insulation screed plus screed; both layers are required.stabilise: stabilised sand (150 kg cement per m³).drainage_mortar: drainage mortar with its additional 5 mm screed top layer.non_tileable_insulation_screed: insulation screed Soft.tileable_insulation_screed: Strong or Cem Mini, each with its own finishing quantities.dry_floor_systems: dry floor grid and/or CircoFloor, with compatible EPS, cork or aerated concrete alternatives.egaline: leveling compound and preparation.none: system hardware only; compatible leveling, screed, dry floor grids and CircoFloor are separate alternatives.systems.sharedComponents once.requiredGroups, choose exactly one option. All items inside that option belong together.For example, Strong and Cem Mini are two options. Each has its own insulation material, primer and leveling compound. Cem Mini uses the calculator's 1 mm allowance instead of Strong's 2 mm; rounding to whole bags happens independently. At eligible screed heights, Cem Mini is also returned as an alternative to screed.
quantity is measured in unit: boxes, bags, bundles, pallets, quarter-pallets, containers, kilograms or tonnes. packageSize and packageUnit describe the package, when known. Thus 2 bundles containing 25 pieces each mean 50 pieces. Do not confuse a package's nominal volume with its effective calculation yield. Ingredient items for self-mix are ingredients, not extra material on top of a total mix.
webshopVariantId is a catalog identifier, not proof of stock or delivery. includedInWebshopProposal states whether the model includes that product in its webshop proposals for the selected country and quantity. This still requires checkout review. minimumOrderQuantity and exceedsMaximumOrder flag order constraints. A retired product may remain as an informative estimate with no shop identifier. An empty group's options mean filler quantities are unavailable for that country; it does not mean the floor needs no filling.
thermalPerformance contains informational material or layer properties. Lambda is in W/(m·K), Rd in m²·K/W. Do not add values belonging to alternatives. No result is a structural assessment or approval of a complete floor assembly.
Present resultUrl as a normal link. It opens the same area, height, filling, country and language on Staenis. The customer can review quantities, request a price including transport or choose ordering options. This API does not return prices, send emails, create leads, change carts or place orders.
The shared service has no request queue: at most 2 concurrent requests, a global burst of 20 requests replenished at 2 per second, and at most 20 requests per client network per fixed minute. These are ceilings, not guaranteed capacity; clients may share a network/budget. Use sequential calls only when needed. Successful results are cached in bounded server memory for 10 minutes.
On 429, respect Retry-After and back off. Do not loop, rotate addresses or retry in parallel. 400 means invalid input; 422 means material-specific validation failed. 405 means GET is required; 503 means temporarily unavailable. Explain failures and offer the ordinary calculator. Do not invent a result.
Compatible browsers can discover staenis_calculate_floor on the calculator page through WebMCP. It calls this same limited API, returns the result and has no form-submission or ordering action. Availability depends on the browser's WebMCP implementation; ordinary visitors can continue using the standard form. There is no remote MCP server at this endpoint.
GET /api/calculator/v2/terrace is a separate, read-only calculation. V1 inputs and results remain unchanged. Required parameters: surfaceM2 (decimal, 1–5000, point separator), thicknessMm (lowest CircoFloor height), tileLengthMm and tileWidthMm (integers, 300–1200), country and culture (as above). Optional: lengthM and widthM together (0.3–200 m each), and heightDifferenceMm (nonnegative integer, default 0). Dimensions determine the actual area when provided. Tile length follows terrace length. Unknown or repeated parameters are rejected. Total query length is limited to 512 characters.
Example: /api/calculator/v2/terrace?surfaceM2=79.36&thicknessMm=100&tileLengthMm=600&tileWidthMm=1200&country=be&culture=nl-BE&lengthM=6.4&widthM=12.4&heightDifferenceMm=30.
The response contains one complete items list: CircoFloor packages plus top and bottom discs. Include all items once. packAreaM2 rounds the area up to whole 2 m²; package sizes are 48, 12 and 2 m². Bottom discs match the supplied black legs (672, 168 and 28 respectively). Top discs count shared corner/edge points once plus one whole centre disc per tile when either tile dimension is at least 600 mm. This inclusive threshold follows Solidor's more conservative product advice. The corner grid uses 3 mm joints and includes cut tiles. Break off the four spacer tabs for a centre support; do not split the disc.
basis distinguishes rectangle-straight from square-area-estimate. Area alone cannot determine perimeter or tile layout: the square is an explicit example, not a project-specific laying plan. Extra supports required by the tile manufacturer, tiles and edge finishing are excluded. The entire height range must fit 88–158 mm or 147–218 mm; discs and tiles add to this height. Ceramic tiles must be at least 20 mm thick and approved for the installation. No structural approval, prices, stock promises, mail, lead, cart mutation or order is produced. The same request and concurrency limits apply to both API versions; v2 quantities are computed directly. Return the visitor to resultUrl for review and an optional price request.