Open the Staenis calculator

Calculator for AI assistants and integrations

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

Calculate

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.

ParameterMeaning
surfaceM2Whole square metres, 1–5000. Do not silently round a customer's dimensions.
thicknessMmWhole 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.
fillingOne of the codes below.
countryRecognized lowercase two-letter ISO country code, for example be. Material and system availability depends on country. Do not substitute Belgium for another country.
culturenl-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.

Filling codes

Read the result correctly

  1. Select exactly one entry from systems.
  2. Include that system's sharedComponents once.
  3. For every entry in requiredGroups, choose exactly one option. All items inside that option belong together.
  4. Never add alternative systems or options together. Required layers are different: include both layers of screed plus insulation. The response gives their separate heights.

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.

Return the customer to their calculation

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.

Limits and errors

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.

Browser tool

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.

Terrace tiles on CircoFloor — v2

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.