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

Parameter
Type
Required
Description

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

Parameter
Type
Required
Description

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

Parameter
Type
Required
Description

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?