Maginium
Admin Api
Admin Api
  • About
  • API reference
    • CustomerGroups
      • Permissions
      • Default
      • Search
    • Customers
      • Confirm
      • BillingAddress
      • ShippingAddress
      • Carts
      • Me
        • Activate
        • Password
        • BillingAddress
        • ShippingAddress
      • Search
      • Activate
      • Password
        • ResetLinkToken
      • ResetPassword
      • Validate
      • IsEmailAvailable
      • Addresses
      • Permissions
        • Readonly
    • CmsPage
      • Search
    • CmsBlock
      • Search
    • Products
      • Media
        • Types
      • Options
        • Types
      • Links
        • Types
        • Attributes
      • Websites
      • Downloadable links
        • Samples
      • Attributes
        • Options
        • Types
      • Attribute sets
        • Attributes
        • Groups
          • List
        • Sets
          • List
      • Tier prices
      • Types
      • Tier prices information
      • Tier prices delete
      • Base prices information
      • Base prices
      • Cost information
      • Cost
      • Cost delete
      • Special price information
      • Special price
      • Special price delete
      • StockItems
      • Group prices
        • Tiers
          • Price
    • Categories
      • Attributes
        • Options
      • Products
      • Move
      • List
    • StockItems
      • LowStock
        • /
    • Carts
      • Items
      • Selected payment method
      • Billing address
      • Coupons
      • Gift message
      • Order
      • Shipping methods
      • Estimate shipping methods by address id
      • Estimate shipping methods
      • Payment methods
      • Totals
      • Shipping information
      • Totals information
      • Mine
        • Items
        • Selected payment method
        • Billing address
        • Coupons
        • Payment information
        • Gift message
        • Order
        • Shipping methods
        • Estimate shipping methods by address id
        • Estimate shipping methods
        • Payment methods
        • Totals
        • Collect totals
        • Shipping information
        • Totals information
        • Set payment information
      • Licence
        • List
      • /
      • Search
    • Guest carts
      • Items
      • Selected payment method
      • Billing address
      • Coupons
      • Payment information
      • Gift message
      • Order
      • Shipping methods
      • Estimate shipping methods
      • Payment methods
      • Collect totals
      • Totals
      • Shipping information
      • Totals information
      • Set payment information
    • Orders
      • Comments
      • Statuses
      • Cancel
      • Emails
      • Hold
      • Unhold
      • Items
      • Create
    • Invoices
      • Comments
      • Emails
      • Void
      • Capture
      • /
    • Creditmemo
      • Comments
      • Emails
      • Refund
    • Shipment
      • Comments
      • Emails
      • Label
      • Track
      • /
    • Transactions
    • TaxRates
      • Search
    • TaxRules
      • Search
    • TaxClasses
      • Search
    • SalesRules
      • Search
    • Coupons
      • Search
      • Generate
      • DeleteByIds
      • DeleteByCodes
    • Bulk
      • Detailed status
      • Status
      • Operation status
    • Modules
    • Search
    • Addresses
    • Products render info
    • StockStatuses
    • Creditmemos
    • Shipments
    • Amazon shipping address
    • Amazon billing address
    • Store
      • StoreViews
      • StoreGroups
      • Websites
      • StoreConfigs
    • Adobestock
      • Asset
        • Search
        • List
      • Search
    • Directory
      • Countries
      • Currency
    • Eav
      • Attribute sets
        • List
    • AttributeMetadata
      • Customer
        • Attribute
        • Form
        • Custom
      • CustomerAddress
        • Attribute
        • Form
        • Custom
    • Bundle products
      • Links
      • Options
        • Children
        • All
        • Types
        • Add
      • Children
    • Order
      • Refund
      • Ship
      • Invoice
      • Notify orders are ready for pickup
    • Configurable products
      • Children
      • Options
        • All
      • Child
      • Variation
    • Inventory
      • Sources
      • Stocks
      • Stock source links
      • Source items
      • Low quantity notification
      • Get sources assigned to stock ordered by priority
      • Stock source links delete
      • Source items delete
      • Bulk product source assign
      • Bulk product source unassign
      • Bulk product source transfer
      • Bulk partial source transfer
      • Get distance provider code
      • Get distance
      • Get latlng from address
      • Get latslngs from address
      • Export stock salable qty
      • Dump stock index data
      • Get product salable quantity
      • Is product salable
      • Are products salable
      • Is product salable for requested qty
      • Stock resolver
      • Source selection algorithm list
      • Source selection algorithm result
      • Low quantity notifications delete
      • Are product salable for requested qty
        • /
      • In store pickup
        • Pickup locations
          • /
    • Invoice
      • Refund
    • Analytics
      • Link
    • Amazon
      • Order ref
    • Applepay
      • Auth
    • Address
      • Cleanse
    • Guest address
      • Cleanse
    • Vertex address validation
      • Vertex address
    • Integration
      • Admin
        • Token
      • Customer
        • Token
Powered by GitBook
On this page
  1. API reference

SalesRules

PreviousSearchNextSearch

sales Rule Rule Repository V1Delete By Id Delete

delete

Delete rule by ID.

Path parameters
ruleIdstringRequired

(Required)

Example: <integer>
Responses
200
OK
application/json
Responseobject
400
Bad Request
application/json
401
Unauthorized
application/json
500
Internal Server Error
application/json
delete
DELETE /V1/salesRules/{ruleId} HTTP/1.1
Host: {{baseurl}}
Accept: */*
true
  • GETsales Rule Rule Repository V1Get By Id Get
  • PUTsales Rule Rule Repository V1Save Put
  • DELETEsales Rule Rule Repository V1Delete By Id Delete
  • POSTsales Rule Rule Repository V1Save Post

sales Rule Rule Repository V1Get By Id Get

get

Get rule by ID.

Path parameters
ruleIdstringRequired

(Required)

Example: <integer>
Responses
200
OK
application/json
Responseobject
400
Bad Request
application/json
401
Unauthorized
application/json
500
Internal Server Error
application/json
get
GET /V1/salesRules/{ruleId} HTTP/1.1
Host: {{baseurl}}
Accept: */*
{
  "website_ids": [
    "<integer>",
    "<integer>"
  ],
  "customer_group_ids": [
    "<integer>",
    "<integer>"
  ],
  "uses_per_customer": "<integer>",
  "is_active": "<boolean>",
  "stop_rules_processing": "<boolean>",
  "is_advanced": "<boolean>",
  "sort_order": "<integer>",
  "discount_amount": "<number>",
  "discount_step": "<integer>",
  "apply_to_shipping": "<boolean>",
  "times_used": "<integer>",
  "is_rss": "<boolean>",
  "coupon_type": "<string>",
  "use_auto_generation": "<boolean>",
  "uses_per_coupon": "<integer>",
  "rule_id": "<integer>",
  "name": "<string>",
  "store_labels": [
    {
      "store_id": "<integer>",
      "store_label": "<string>",
      "extension_attributes": "<object>"
    },
    {
      "store_id": "<integer>",
      "store_label": "<string>",
      "extension_attributes": "<object>"
    }
  ],
  "description": "<string>",
  "from_date": "<string>",
  "to_date": "<string>",
  "condition": {
    "condition_type": "<string>",
    "operator": "<string>",
    "value": "<string>",
    "conditions": [
      {
        "value": "<Circular reference to #/components/schemas/sales-rule-data-condition-interface detected>"
      },
      {
        "value": "<Circular reference to #/components/schemas/sales-rule-data-condition-interface detected>"
      }
    ],
    "aggregator_type": "<string>",
    "attribute_name": "<string>",
    "extension_attributes": "<object>"
  },
  "action_condition": {
    "condition_type": "<string>",
    "operator": "<string>",
    "value": "<string>",
    "conditions": [
      {
        "value": "<Circular reference to #/components/schemas/sales-rule-data-condition-interface detected>"
      },
      {
        "value": "<Circular reference to #/components/schemas/sales-rule-data-condition-interface detected>"
      }
    ],
    "aggregator_type": "<string>",
    "attribute_name": "<string>",
    "extension_attributes": "<object>"
  },
  "product_ids": [
    "<integer>",
    "<integer>"
  ],
  "simple_action": "<string>",
  "discount_qty": "<number>",
  "simple_free_shipping": "<string>",
  "extension_attributes": "<object>"
}

sales Rule Rule Repository V1Save Put

put

Save sales rule.

Path parameters
ruleIdstringRequired

(Required)

Example: <string>
Header parameters
Content-TypestringOptionalExample: application/json
Body
objectOptionalExample: {"rule":{"website_ids":["<integer>","<integer>"],"customer_group_ids":["<integer>","<integer>"],"uses_per_customer":"<integer>","is_active":"<boolean>","stop_rules_processing":"<boolean>","is_advanced":"<boolean>","sort_order":"<integer>","discount_amount":"<number>","discount_step":"<integer>","apply_to_shipping":"<boolean>","times_used":"<integer>","is_rss":"<boolean>","coupon_type":"<string>","use_auto_generation":"<boolean>","uses_per_coupon":"<integer>","rule_id":"<integer>","name":"<string>","store_labels":[{"store_id":"<integer>","store_label":"<string>","extension_attributes":"<object>"},{"store_id":"<integer>","store_label":"<string>","extension_attributes":"<object>"}],"description":"<string>","from_date":"<string>","to_date":"<string>","condition":{"condition_type":"<string>","operator":"<string>","value":"<string>","conditions":[{"value":"<Circular reference to #/components/schemas/sales-rule-data-condition-interface detected>"},{"value":"<Circular reference to #/components/schemas/sales-rule-data-condition-interface detected>"}],"aggregator_type":"<string>","attribute_name":"<string>","extension_attributes":"<object>"},"action_condition":{"condition_type":"<string>","operator":"<string>","value":"<string>","conditions":[{"value":"<Circular reference to #/components/schemas/sales-rule-data-condition-interface detected>"},{"value":"<Circular reference to #/components/schemas/sales-rule-data-condition-interface detected>"}],"aggregator_type":"<string>","attribute_name":"<string>","extension_attributes":"<object>"},"product_ids":["<integer>","<integer>"],"simple_action":"<string>","discount_qty":"<number>","simple_free_shipping":"<string>","extension_attributes":"<object>"}}
Responses
200
OK
application/json
Responseobject
400
Bad Request
application/json
401
Unauthorized
application/json
500
Internal Server Error
application/json
put
PUT /V1/salesRules/{ruleId} HTTP/1.1
Host: {{baseurl}}
Content-Type: application/json
Accept: */*
Content-Length: 1712

{
  "rule": {
    "website_ids": [
      "<integer>",
      "<integer>"
    ],
    "customer_group_ids": [
      "<integer>",
      "<integer>"
    ],
    "uses_per_customer": "<integer>",
    "is_active": "<boolean>",
    "stop_rules_processing": "<boolean>",
    "is_advanced": "<boolean>",
    "sort_order": "<integer>",
    "discount_amount": "<number>",
    "discount_step": "<integer>",
    "apply_to_shipping": "<boolean>",
    "times_used": "<integer>",
    "is_rss": "<boolean>",
    "coupon_type": "<string>",
    "use_auto_generation": "<boolean>",
    "uses_per_coupon": "<integer>",
    "rule_id": "<integer>",
    "name": "<string>",
    "store_labels": [
      {
        "store_id": "<integer>",
        "store_label": "<string>",
        "extension_attributes": "<object>"
      },
      {
        "store_id": "<integer>",
        "store_label": "<string>",
        "extension_attributes": "<object>"
      }
    ],
    "description": "<string>",
    "from_date": "<string>",
    "to_date": "<string>",
    "condition": {
      "condition_type": "<string>",
      "operator": "<string>",
      "value": "<string>",
      "conditions": [
        {
          "value": "<Circular reference to #/components/schemas/sales-rule-data-condition-interface detected>"
        },
        {
          "value": "<Circular reference to #/components/schemas/sales-rule-data-condition-interface detected>"
        }
      ],
      "aggregator_type": "<string>",
      "attribute_name": "<string>",
      "extension_attributes": "<object>"
    },
    "action_condition": {
      "condition_type": "<string>",
      "operator": "<string>",
      "value": "<string>",
      "conditions": [
        {
          "value": "<Circular reference to #/components/schemas/sales-rule-data-condition-interface detected>"
        },
        {
          "value": "<Circular reference to #/components/schemas/sales-rule-data-condition-interface detected>"
        }
      ],
      "aggregator_type": "<string>",
      "attribute_name": "<string>",
      "extension_attributes": "<object>"
    },
    "product_ids": [
      "<integer>",
      "<integer>"
    ],
    "simple_action": "<string>",
    "discount_qty": "<number>",
    "simple_free_shipping": "<string>",
    "extension_attributes": "<object>"
  }
}
{
  "website_ids": [
    "<integer>",
    "<integer>"
  ],
  "customer_group_ids": [
    "<integer>",
    "<integer>"
  ],
  "uses_per_customer": "<integer>",
  "is_active": "<boolean>",
  "stop_rules_processing": "<boolean>",
  "is_advanced": "<boolean>",
  "sort_order": "<integer>",
  "discount_amount": "<number>",
  "discount_step": "<integer>",
  "apply_to_shipping": "<boolean>",
  "times_used": "<integer>",
  "is_rss": "<boolean>",
  "coupon_type": "<string>",
  "use_auto_generation": "<boolean>",
  "uses_per_coupon": "<integer>",
  "rule_id": "<integer>",
  "name": "<string>",
  "store_labels": [
    {
      "store_id": "<integer>",
      "store_label": "<string>",
      "extension_attributes": "<object>"
    },
    {
      "store_id": "<integer>",
      "store_label": "<string>",
      "extension_attributes": "<object>"
    }
  ],
  "description": "<string>",
  "from_date": "<string>",
  "to_date": "<string>",
  "condition": {
    "condition_type": "<string>",
    "operator": "<string>",
    "value": "<string>",
    "conditions": [
      {
        "value": "<Circular reference to #/components/schemas/sales-rule-data-condition-interface detected>"
      },
      {
        "value": "<Circular reference to #/components/schemas/sales-rule-data-condition-interface detected>"
      }
    ],
    "aggregator_type": "<string>",
    "attribute_name": "<string>",
    "extension_attributes": "<object>"
  },
  "action_condition": {
    "condition_type": "<string>",
    "operator": "<string>",
    "value": "<string>",
    "conditions": [
      {
        "value": "<Circular reference to #/components/schemas/sales-rule-data-condition-interface detected>"
      },
      {
        "value": "<Circular reference to #/components/schemas/sales-rule-data-condition-interface detected>"
      }
    ],
    "aggregator_type": "<string>",
    "attribute_name": "<string>",
    "extension_attributes": "<object>"
  },
  "product_ids": [
    "<integer>",
    "<integer>"
  ],
  "simple_action": "<string>",
  "discount_qty": "<number>",
  "simple_free_shipping": "<string>",
  "extension_attributes": "<object>"
}

sales Rule Rule Repository V1Save Post

post

Save sales rule.

Header parameters
Content-TypestringOptionalExample: application/json
Body
objectOptionalExample: {"rule":{"website_ids":["<integer>","<integer>"],"customer_group_ids":["<integer>","<integer>"],"uses_per_customer":"<integer>","is_active":"<boolean>","stop_rules_processing":"<boolean>","is_advanced":"<boolean>","sort_order":"<integer>","discount_amount":"<number>","discount_step":"<integer>","apply_to_shipping":"<boolean>","times_used":"<integer>","is_rss":"<boolean>","coupon_type":"<string>","use_auto_generation":"<boolean>","uses_per_coupon":"<integer>","rule_id":"<integer>","name":"<string>","store_labels":[{"store_id":"<integer>","store_label":"<string>","extension_attributes":"<object>"},{"store_id":"<integer>","store_label":"<string>","extension_attributes":"<object>"}],"description":"<string>","from_date":"<string>","to_date":"<string>","condition":{"condition_type":"<string>","operator":"<string>","value":"<string>","conditions":[{"value":"<Circular reference to #/components/schemas/sales-rule-data-condition-interface detected>"},{"value":"<Circular reference to #/components/schemas/sales-rule-data-condition-interface detected>"}],"aggregator_type":"<string>","attribute_name":"<string>","extension_attributes":"<object>"},"action_condition":{"condition_type":"<string>","operator":"<string>","value":"<string>","conditions":[{"value":"<Circular reference to #/components/schemas/sales-rule-data-condition-interface detected>"},{"value":"<Circular reference to #/components/schemas/sales-rule-data-condition-interface detected>"}],"aggregator_type":"<string>","attribute_name":"<string>","extension_attributes":"<object>"},"product_ids":["<integer>","<integer>"],"simple_action":"<string>","discount_qty":"<number>","simple_free_shipping":"<string>","extension_attributes":"<object>"}}
Responses
200
OK
application/json
Responseobject
400
Bad Request
application/json
401
Unauthorized
application/json
500
Internal Server Error
application/json
post
POST /V1/salesRules HTTP/1.1
Host: {{baseurl}}
Content-Type: application/json
Accept: */*
Content-Length: 1712

{
  "rule": {
    "website_ids": [
      "<integer>",
      "<integer>"
    ],
    "customer_group_ids": [
      "<integer>",
      "<integer>"
    ],
    "uses_per_customer": "<integer>",
    "is_active": "<boolean>",
    "stop_rules_processing": "<boolean>",
    "is_advanced": "<boolean>",
    "sort_order": "<integer>",
    "discount_amount": "<number>",
    "discount_step": "<integer>",
    "apply_to_shipping": "<boolean>",
    "times_used": "<integer>",
    "is_rss": "<boolean>",
    "coupon_type": "<string>",
    "use_auto_generation": "<boolean>",
    "uses_per_coupon": "<integer>",
    "rule_id": "<integer>",
    "name": "<string>",
    "store_labels": [
      {
        "store_id": "<integer>",
        "store_label": "<string>",
        "extension_attributes": "<object>"
      },
      {
        "store_id": "<integer>",
        "store_label": "<string>",
        "extension_attributes": "<object>"
      }
    ],
    "description": "<string>",
    "from_date": "<string>",
    "to_date": "<string>",
    "condition": {
      "condition_type": "<string>",
      "operator": "<string>",
      "value": "<string>",
      "conditions": [
        {
          "value": "<Circular reference to #/components/schemas/sales-rule-data-condition-interface detected>"
        },
        {
          "value": "<Circular reference to #/components/schemas/sales-rule-data-condition-interface detected>"
        }
      ],
      "aggregator_type": "<string>",
      "attribute_name": "<string>",
      "extension_attributes": "<object>"
    },
    "action_condition": {
      "condition_type": "<string>",
      "operator": "<string>",
      "value": "<string>",
      "conditions": [
        {
          "value": "<Circular reference to #/components/schemas/sales-rule-data-condition-interface detected>"
        },
        {
          "value": "<Circular reference to #/components/schemas/sales-rule-data-condition-interface detected>"
        }
      ],
      "aggregator_type": "<string>",
      "attribute_name": "<string>",
      "extension_attributes": "<object>"
    },
    "product_ids": [
      "<integer>",
      "<integer>"
    ],
    "simple_action": "<string>",
    "discount_qty": "<number>",
    "simple_free_shipping": "<string>",
    "extension_attributes": "<object>"
  }
}
{
  "website_ids": [
    "<integer>",
    "<integer>"
  ],
  "customer_group_ids": [
    "<integer>",
    "<integer>"
  ],
  "uses_per_customer": "<integer>",
  "is_active": "<boolean>",
  "stop_rules_processing": "<boolean>",
  "is_advanced": "<boolean>",
  "sort_order": "<integer>",
  "discount_amount": "<number>",
  "discount_step": "<integer>",
  "apply_to_shipping": "<boolean>",
  "times_used": "<integer>",
  "is_rss": "<boolean>",
  "coupon_type": "<string>",
  "use_auto_generation": "<boolean>",
  "uses_per_coupon": "<integer>",
  "rule_id": "<integer>",
  "name": "<string>",
  "store_labels": [
    {
      "store_id": "<integer>",
      "store_label": "<string>",
      "extension_attributes": "<object>"
    },
    {
      "store_id": "<integer>",
      "store_label": "<string>",
      "extension_attributes": "<object>"
    }
  ],
  "description": "<string>",
  "from_date": "<string>",
  "to_date": "<string>",
  "condition": {
    "condition_type": "<string>",
    "operator": "<string>",
    "value": "<string>",
    "conditions": [
      {
        "value": "<Circular reference to #/components/schemas/sales-rule-data-condition-interface detected>"
      },
      {
        "value": "<Circular reference to #/components/schemas/sales-rule-data-condition-interface detected>"
      }
    ],
    "aggregator_type": "<string>",
    "attribute_name": "<string>",
    "extension_attributes": "<object>"
  },
  "action_condition": {
    "condition_type": "<string>",
    "operator": "<string>",
    "value": "<string>",
    "conditions": [
      {
        "value": "<Circular reference to #/components/schemas/sales-rule-data-condition-interface detected>"
      },
      {
        "value": "<Circular reference to #/components/schemas/sales-rule-data-condition-interface detected>"
      }
    ],
    "aggregator_type": "<string>",
    "attribute_name": "<string>",
    "extension_attributes": "<object>"
  },
  "product_ids": [
    "<integer>",
    "<integer>"
  ],
  "simple_action": "<string>",
  "discount_qty": "<number>",
  "simple_free_shipping": "<string>",
  "extension_attributes": "<object>"
}