List Catalog Rules

Lists every catalog rule in the store — the data behind the admin Marketing → Promotions → Catalog Rules datagrid.

TIP

New here? Read the Catalog Rules overview for what a catalog rule does and how its fields behave.

Operation

Operation	Type	Purpose
adminMarketingCatalogRules	Query	Cursor-paginated list of all catalog rules

Details

• Requires an admin Bearer token in the Authorization header.
• Cursor pagination — pass first for the page size and after (the endCursor from the previous page) to advance. totalCount is the grand total.
• Each node carries the flat rule fields shown in the example. The heavier conditions, channels, and customerGroups resolve only on the detail query — they are null on list rows.

Filtering

Pass any of these arguments alongside first / after (they mirror the admin datagrid filters):

Argument	Description
id	Single id or comma-separated list (e.g. 1,4,9)
name	Name — partial match
status	0 (inactive) / 1 (active)
sort_order	Priority — exact match
starts_from_from, starts_from_to	Start-date range (ISO 8601)
ends_till_from, ends_till_to	End-date range (ISO 8601)
sort, order	Sort field (id, name, sort_order) + asc / desc (default id desc)