Store API
PremsManufacturer provides three store-api routes for retrieving manufacturer data from composable storefronts or custom frontends.
Load Manufacturer List
Returns a paginated list of manufacturers, optionally filtered by starting letter or search term.
Endpoint: POST /store-api/prems-manufacturer/list
Login required: No
page
int
No
Page number (starting at 1). Default: 1.
limit
int
No
Number of manufacturers per page. Default: 24.
letter
string
No
Starting letter (A–Z) or "0-9" for numeric manufacturers.
search
string
No
Search term inside the manufacturer name (contains filter).
Response: Returns a manufacturer collection with total count and — if the Advanced version is active — a list of letters that have at least one manufacturer for the A-Z navigation.
Errors:
The free version returns at most 5 manufacturers; the A-Z letter list is empty.
Load Manufacturer Detail
Returns a single manufacturer including a fully-featured product listing.
Endpoint: POST /store-api/prems-manufacturer/detail/{manufacturerId}
Login required: No
manufacturerId
string
Yes
Manufacturer ID, taken from the URL path.
order
string
No
Sorting key (see core.listing.defaultSorting).
p
int
No
Product list page.
limit
int
No
Products per page.
manufacturer-filter, rating-filter, price-filter, shipping-free-filter, property-filter
bool
No
Toggles individual listing filters (same semantics as Shopware's standard listing filters).
Response: Returns the manufacturer entity and the product listing with available sortings, aggregations, applied filters, and the current filter state.
Errors:
404– No manufacturer exists with the given ID.
Manufacturer Suggest
Returns a reduced manufacturer list for the search suggest dropdown in the header.
Endpoint: POST /store-api/prems-manufacturer/suggest
Login required: No
search
string
No
Search term (contains filter on the manufacturer name).
limit
int
No
Maximum number of results (1–20). Default: 5.
Response: Returns a small manufacturer collection including the logo media association.
Errors:
This route is only available in the Advanced version; the free version always returns an empty collection.
Was this helpful?
