Skip to content

Export Products

Downloads the products datagrid as a CSV file — the same data the admin Catalog → Products "Export" button produces. The response is a binary text/csv attachment, not JSON.

Unlike the listing, the export is not paginated — it streams every row that matches the current filters, so you can export a whole filtered catalog in one call.

REST only

There is no GraphQL counterpart — binary file streams aren't expressible over GraphQL. Use this REST endpoint for the export.

Endpoint

EndpointMethod
/api/admin/catalog/products/exportGET

Request headers

HeaderValue
AuthorizationBearer <token>
Accepttext/csvrequired. The endpoint only produces text/csv; sending Accept: application/json returns 406 Not Acceptable.

Query parameters

ParameterTypeDescription
formatstringExport format — only csv is supported (the default). Any other value returns 422.

The export also accepts the same filters as the listing, AND-combined (more filters = narrower result):

FilterTypeDescription
channelstringChannel code for value resolution.
namestringPartial product-name match.
skustringPartial SKU match.
attribute_familyintegerAttribute-family ID.
price_from / price_tonumberPrice band (inclusive). price=50,200 is shorthand for both.
product_idstringA single ID or a comma-separated list (e.g. 1,22,2705).
statusinteger0 (disabled) or 1 (active).
typestringsimple, virtual, downloadable, grouped, bundle, configurable, booking.

Columns

The CSV carries the nine datagrid columns, in order:

HeaderValue
IDProduct ID.
NameProduct name for the resolved locale (empty for draft products with no name yet).
SKUProduct SKU.
Attribute FamilyThe product's attribute-family name.
PriceThe base price, formatted (e.g. $100.00). Empty for composite types (configurable / bundle / grouped / booking) that carry no own price.
QuantityTotal stock across inventory sources.
StatusActive or Disabled.
CategoryThe primary category name (empty when uncategorised).
TypeThe product type.

Permission

catalog.products

Released under the MIT License.