Skip to main content
Version: 2.0.0

Catalog Endpoints


Product listing

GET /shop/catalog/products

Renders the product catalog/listing page. This is a full HTML page response using the template defined on the product type's routing settings.

Multi-language aliases are also registered automatically:

RouteDescription
/productsEnglish alias
/produktySlovak/Czech alias
/produkteGerman alias
/termekekHungarian alias

These can be customised per-project in the product type routing configuration.


Search results

GET /shop/catalog/search-results

Renders the search results page.

Query parameters:

ParameterDescription
qSearch query string

Product not found

GET /shop/catalog/product-404

Rendered when a product URL resolves but the product is not found or not visible (deleted, disabled, wrong store). Returns a 404 status.


Abandoned cart recovery

GET /shop/marketing/abandoned-carts/recover/{cart_id}

Restores an abandoned cart by its cart ID. Used in abandoned cart recovery emails — the link in the email points to this endpoint, which restores the cart items into a new session and redirects to the cart page.

Feature flag

Only registered when salesAbandonedCartsEnabled is on.


Gift card preview

GET /shop/marketing/gift-cards/preview/{id}
GET /shop/marketing/gift-cards/preview-card/{code}
GET /shop/marketing/gift-cards/item-details/{code}
EndpointDescription
preview/{id}Preview a gift card design by design ID
preview-card/{code}Preview a specific gift card code's voucher PDF
item-details/{code}Returns JSON details for a gift card code (balance, expiry, status)
Feature flag

Only registered when salesGiftCardsEnabled is on.