Our public interfaces for retailers, partners, developers and AI agents: calculate shipping costs, check stock, load product data, prepare shopping carts and evaluate configurations from the 3D configurator. All interfaces described here are free, read-only and require no sign-up.
ℹ️ General
Format: JSON (UTF-8); amounts as strings with a dot, e.g. "18.14", in EUR (unless stated otherwise).
Authentication: none. All endpoints described here are public and read-only.
Error 403? Our servers are behind Cloudflare. curl, Python requests and JavaScript fetch work without any further settings; some libraries (e.g. Python urllib) are rejected. In that case, send your own User-Agent, e.g. MeineFirma-Integration/1.0 (kontakt@example.com).
Calling from the browser (CORS): the stock API and the product feeds can be called from any website. The shipping API is intended for server-to-server calls – call it from your backend.
Limits: shipping costs for configurations: 60 requests per minute and IP address (then 429). Please do not request data more often than necessary and cache results briefly (e.g. stock for 5–10 minutes).
Errors: HTTP status codes (400 invalid input, 404 not found, 422 missing or invalid parameters, 429 too many requests). The message is in the detail or error field.
For AI agents: a compact overview for language models is available at /llms.txt and /agents.md.
🚚 Shipping API
Base URL:https://modula24.com
Calculates shipping costs exactly like our cart and checkout – for a cart, for weights or for a configuration from the 3D configurator. Goods from our Hamburg warehouse ship with DHL (parcels up to 31.5 kg); goods only stocked in our China warehouse ship by sea or air freight. If only part is in Hamburg, a split shipment is offered. The API determines which items are where from the current stock.
Shipping methods (id): dhl (from Hamburg: DHL Paket International Premium, door delivery; within Germany DHL parcel), dhl_eco (from Hamburg: DHL Paket International Economy, delivery to a parcel locker/post office – only outside the EU and not in all countries), sea / air (China-only goods), split_sea / split_air (split shipment: Hamburg by DHL Premium, the rest from China), air_door (outside the EU only, if the order includes Hamburg stock: whole order from the China warehouse by air to the door, customs cleared, 7–10 working days), pallet (pallet by freight forwarder from Hamburg, Germany/EU/Switzerland/Norway/Iceland only, up to 750 kg per pallet, from 100 kg, sorted by price), fourpx (4PX: whole order from the China warehouse, tracked, customs paid by the shop; also within the EU, not in all countries), sea_door (outside the EU only: whole order from the China warehouse by sea to the door, customs cleared, 9–11 weeks – always listed last). The tariff is also given in legs[].product. Each option contains cost, the delivery time days with unit (days = working days, weeks) and the individual parts of the shipment legs. The cheapest option comes first (except air_door, fourpx and sea_door, which are always listed last).
GET/api/checkout/config
Delivery countries – List of delivery countries (ISO 3166 codes) and currencies. We only deliver to these countries.
curl https://modula24.com/api/checkout/config
const res = await fetch('https://modula24.com/api/checkout/config');
const { countries } = await res.json();
console.log(countries); // ["AT", "AU", "BE", ...]
import requests
r = requests.get("https://modula24.com/api/checkout/config", timeout=10)
print(r.json()["countries"])
Shipping costs for a configuration – For a saved configuration from the 3D configurator: the parts list is converted into shop items as with the “Add to cart” button. Without country, you get the options for all delivery countries (countries). Parts without an available shop item are listed in missing – their weight is not included and complete is false. Also available as POST with {"config": "…"} or a parts list {"bom": […]}. Max. 60 requests per minute.
Parameters
Name
In
Type
Description
configrequired
query
string
Configuration ID (e.g. LFKDD5KLP9MG)
countryoptional
query
string
Delivery country; empty = all countries
currencyoptional
query
string
EUR or USD
missingoptional
query
integer
1 = also returns missing_shipping: estimated shipping for the unavailable parts from our China warehouse (weight from the catalogue or estimated by area/length, +10 % packaging; options such as sea/air freight, 4PX, fourpx_split = split into 30 kg parcels). Guide value excluding customs/import VAT; these parts cannot be ordered in the shop. POST: "missing": true
curl "https://modula24.com/api/checkout/shipping?config=LFKDD5KLP9MG&country=AT"
# mit Versand-Schätzung für nicht lieferbare Teile (ab China)
curl "https://modula24.com/api/checkout/shipping?config=8JUKX9TJ2WSK&country=DE&missing=1"
const url = new URL('https://modula24.com/api/checkout/shipping');
url.searchParams.set('config', 'LFKDD5KLP9MG');
url.searchParams.set('country', 'AT');
const data = await (await fetch(url)).json();
if (!data.complete) console.warn('Nicht enthalten:', data.missing);
console.log(data.shipping_options, data.cart_url);
import requests
r = requests.get("https://modula24.com/api/checkout/shipping",
params={"config": "LFKDD5KLP9MG", "country": "AT"}, timeout=10)
d = r.json()
print(d["complete"], d["weight_kg"], d["shipping_options"], d["cart_url"])
Current stock of our warehouse in Hamburg (hamburg) per stock SKU. Ideal for retailers, price comparison and ERP systems. The data is updated continuously (sales across all channels are booked every 10 minutes); the data_updated_at field shows the latest change. Can also be called directly from the browser (CORS).
Fields per item:sku, warehouse, title, price + currency (same price as in the shop; null if the item is not sold in the shop), available (available quantity), ean, url (product page on modula24.com, German), urls (product page per language: de, en, fr, it), updated_at. If an item is not offered on modula24.com, url and urls are null.
GET/stock
Query stock – All items or filtered. Filters can be combined.
Parameters
Name
In
Type
Description
warehouseoptional
query
string
Warehouse ID (see /warehouses), currently hamburg; empty = all
const res = await fetch('https://api.modula24.com/stock?warehouse=hamburg&in_stock=true');
const { items, data_updated_at } = await res.json();
for (const i of items) console.log(i.sku, i.available);
import requests
r = requests.get("https://api.modula24.com/stock",
params={"warehouse": "hamburg", "skus": "kugel,rohr_350"}, timeout=10)
for item in r.json()["items"]:
print(item["sku"], item["available"])
All orderable items with price, availability, images, weight, category, colour/size and shipping cost per destination country (1 unit, cheapest option) – per language as JSON and in Google Merchant Center format. The feeds are regenerated with every change in the shop. You need the variant_id for the shipping API and the cart link.
GET/products.json
Products (Shopify-compatible) – All products with variants in the familiar Shopify format – existing Shopify tools keep working. Single product: /products/{handle}.json, products of a category: /collections/{handle}/products.json. Other languages with a prefix, e.g. /en/products.json. The variant id is the variant_id for the shipping API and the cart link.
Parameters
Name
In
Type
Description
handleoptional
path
string
URL name of the product or category (from the link)
const { product } = await (await fetch('https://modula24.com/products/rohr-ohne-bohrung-100-mm-bis-750-mm-usm-haller.json')).json();
for (const v of product.variants) console.log(v.id, v.title, v.price, v.available);
import requests
r = requests.get("https://modula24.com/products/rohr-ohne-bohrung-100-mm-bis-750-mm-usm-haller.json", timeout=10)
for v in r.json()["product"]["variants"]:
print(v["id"], v["title"], v["price"], v["available"])
Google Merchant feed (XML) – RSS 2.0 with Google namespace for Merchant Center, price comparison sites and marketplaces. {lang} = de, en, fr, it, ja or us (USD). Also: /sitemap.xml.
Parameters
Name
In
Type
Description
langrequired
path
string
Language or us
curl https://modula24.com/feeds/google.de.xml
const xml = await (await fetch('https://modula24.com/feeds/google.de.xml')).text();
const doc = new DOMParser().parseFromString(xml, 'application/xml');
console.log(doc.querySelectorAll('item').length);
import requests, xml.etree.ElementTree as ET
xml = requests.get("https://modula24.com/feeds/google.de.xml", timeout=20).content
G = "{http://base.google.com/ns/1.0}"
for item in ET.fromstring(xml).iter("item"):
print(item.find(G + "id").text, item.find("title").text, item.find(G + "price").text)
Response (shortened)
<rss version="2.0" xmlns:g="http://base.google.com/ns/1.0"><channel>
<item>
<g:id>M24-58436517069064</g:id>
<title>Konnektor Connector Verbindung - 100% kompatibel mit USM Haller</title>
<g:price>0.95 EUR</g:price>
<g:availability>in_stock</g:availability>
…
</item>
🛒 Cart link
Base URL:https://modula24.com
A link that puts items directly into a visitor’s cart – e.g. from a parts list, a quote, a planning tool or an AI assistant. The visitor sees “N items were added to the cart” and orders in the checkout themselves. Only known, available variants are added; items already in the cart remain, identical variants are added up. Max. 60 lines per link.
LINK/cart?add={variant_id}:{qty},…
Add items to the cart – Languages: /cart (German), /en/cart, /fr/cart, /it/cart, /ja/cart. With &cfg=ID the configuration ID is shown as well.
items = [("58436497375496", 8), ("58546503745800", 8)]
url = "https://modula24.com/cart?add=" + ",".join(f"{vid}:{qty}" for vid, qty in items)
print(url)
🧩 Configurator API
Base URL:https://konfigurator.modula24.com
Every configuration saved in the 3D configurator has a 12-character ID (e.g. LFKDD5KLP9MG). With this ID you can open the configuration, retrieve price, weight and outer dimensions, convert it into shop items (for the cart link) and calculate the shipping costs (see Shipping API). Open the configurator: https://konfigurator.modula24.com/?load=ID.
GET/checkout-api.php?action=summary&id={id}
Summary – Price according to the configurator, weight, outer dimensions (mm) and parts list.
As shop items – Converts the parts list into orderable shop items (lines) and returns the ready-made cart link (url). Parts not available in the shop are listed in missing.
Gallery images – Photorealistic AI images of real configurations with colour, outer dimensions (mm), compartments and configuration ID. Image URL: https://konfigurator.modula24.com/images/ai/{file}.
import requests
r = requests.get("https://konfigurator.modula24.com/galerie.php",
params={"format": "json"}, timeout=20)
for im in r.json()["images"][:3]:
print(im["cfg"], im["code"], im["dims"])