Built the way you’d build it.
Two APIs: the Storefront API for your frontend, the Management API for integrations and scripts. Amounts in cents, everything inside data, predictable down to the errors.
- One error shape, everywhere Always a stable code and a readable message: 422 validation_failed for invalid input, 409 for a conflict, such as insufficient stock.
- Fast by caching Catalogue and page responses carry an ETag; unchanged simply means 304.
- Safe to retry Writes in the Management API accept an Idempotency-Key. Send it twice, it’s booked once.
- Scoped keys Keys per shop with exactly the permissions an integration needs.
- Public OpenAPI docs An interactive reference for both APIs; generate a client straight from it.
curl https://api.vendum.io/v1/storefront/products/leather-boot \
-H "X-Tenant-Key: pk_…" \
-H "Accept-Language: en"const res = await fetch('https://api.vendum.io/v1/storefront/products/leather-boot', {
headers: { 'X-Tenant-Key': 'pk_…', 'Accept-Language': 'en' },
});
const { data: product } = await res.json();use Illuminate\Support\Facades\Http;
$product = Http::withHeaders(['X-Tenant-Key' => 'pk_…'])
->get('https://api.vendum.io/v1/storefront/products/leather-boot')
->json('data');import requests
res = requests.get(
'https://api.vendum.io/v1/storefront/products/leather-boot',
headers={'X-Tenant-Key': 'pk_…', 'Accept-Language': 'en'},
)
product = res.json()['data'] {
"data": {
"id": 128,
"name": "Leather boot",
"slug": "leather-boot",
"price": 18995,
"currency": "EUR",
"sale_price": null,
"in_stock": true,
"options": [
{ "id": 5, "name": "Colour", "values": ["Brown", "Black"] }
],
"variants": [
{ "id": 341, "sku": "BOOT-42", "price": 18995,
"stock_quantity": 7, "in_stock": true,
"options": [{ "option_id": 5, "value_id": 21, "value": "Brown" }] }
]
}
} {
"error": "insufficient_stock",
"message": "Insufficient stock for this variant.",
"items": [{ "product_variant_id": 341, "available": 2, "in_cart": 1 }]
}Your frontend, your stack.
We provide the backend: catalogue, cart, checkout, customers and orders. You, or your developer, build the frontend with whatever you like. It all speaks JSON over HTTPS.
- A website
Next, Astro, Nuxt, SvelteKit or plain HTML: fetch products and pages, fill a cart and check out with
POST /checkout. - An app
iOS, Android or React Native use the same Storefront API, with the same cart and customer accounts.
- Your own integrations
Scanners, tills and scripts work with the Management API: orders, labels and stock, with a key per integration.
---
const res = await fetch(`${API}/products/leather-boot`, {
headers: { 'X-Tenant-Key': import.meta.env.TENANT_KEY },
});
const { data: p } = await res.json();
const euro = (c) =>
(c / 100).toLocaleString(Astro.currentLocale, {
style: 'currency', currency: p.currency,
});
---
<article>
<h3>{p.name}</h3>
<p>{euro(p.sale_price ?? p.price)}</p>
{p.options[0].values.map((v) => <button>{v}</button>)}
</article>Leather boot
€189.95
Example: this component, rendered with data from GET /products/leather-boot.
Start today, open when you’re ready.
Create an account, verify your payment details for €0.00 and your first month starts.