> ## Documentation Index
> Fetch the complete documentation index at: https://developers.redo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# checkoutDiscountRules

> The store's checkout discount rules: whether they are on, whether they can be turned on, the active rules in evaluation order, and the inactive rules.

**Required scopes:** [`checkout_read`](https://developers.redo.com/docs/api-reference/v3/reference/scopes#scope-checkout_read)

## Returns

**checkoutDiscountRules** `[CheckoutDiscountRules!](/docs/api-reference/v3/reference/checkout/checkout-discount-rules)` *required*

The store's checkout discount rules and whether they are on.

**fields**

**activeRules** `[\[CheckoutDiscountRule!\]!](/docs/api-reference/v3/reference/checkout/checkout-discount-rule)` *required*

Active rules in evaluation order. At checkout the first one whose conditions match wins.

**fields**

**active** `Boolean!` *required*

Whether the rule is evaluated at checkout while discount rules are on.

**conditions** `[CheckoutDiscountRuleConditions!](/docs/api-reference/v3/reference/checkout/checkout-discount-rule-conditions)` *required*

When the rule applies.

**fields**

**blocks** `[\[CheckoutDiscountRuleConditionBlock!\]!](/docs/api-reference/v3/reference/checkout/checkout-discount-rule-condition-block)` *required*

Groups of conditions, at most 6.

**conjunction** `[CheckoutDiscountRuleConjunction!](/docs/api-reference/v3/reference/checkout/checkout-discount-rule-conjunction)` *required*

How the blocks combine.

**createdAt** `[DateTime!](/docs/api-reference/v3/reference/common/date-time)` *required*

When the rule was created.

**discount** `[CheckoutDiscountRuleDiscount!](/docs/api-reference/v3/reference/checkout/checkout-discount-rule-discount)` *required*

What the rule takes off.

**id** `ID!` *required*

The rule's id.

**message** `String!` *required*

Shopper-facing text shown with the discounted price.

**target** `[CheckoutDiscountRuleTarget!](/docs/api-reference/v3/reference/checkout/checkout-discount-rule-target)` *required*

What the rule discounts.

**updatedAt** `[DateTime!](/docs/api-reference/v3/reference/common/date-time)` *required*

When the rule was last changed.

**eligibility** `[CheckoutDiscountRulesEligibility!](/docs/api-reference/v3/reference/checkout/checkout-discount-rules-eligibility)` *required*

Whether discount rules can be turned on.

**fields**

**eligible** `Boolean!` *required*

True when nothing blocks turning discount rules on.

**reasons** `[\[CheckoutDiscountRulesIneligibleReason!\]!](/docs/api-reference/v3/reference/checkout/checkout-discount-rules-ineligible-reason)` *required*

What blocks it. Empty when eligible.

**enabled** `Boolean!` *required*

Whether discount rules are on. While off, no rule applies at checkout, active or not.

**inactiveRules** `[CheckoutDiscountRuleConnection!](/docs/api-reference/v3/pagination)` *required*

Inactive rules, oldest first. Cursors are positional, so a rule can shift if rules are created, activated or deleted while you page.

**fields**

**Arguments**

**after** `String`

Return rules after this cursor.

**before** `String`

Return rules before this cursor.

**first** `Int`

Page size.

**last** `Int`

Page size, paging backward.

**Fields**

**edges** `[\[CheckoutDiscountRuleEdge!\]!](/docs/api-reference/v3/pagination)` *required*

The list of edges (each a node plus its pagination `cursor`).

**fields**

**cursor** `String!` *required*

Opaque cursor for this item; pass to `after`/`before` to page from here.

**node** `[CheckoutDiscountRule!](/docs/api-reference/v3/reference/checkout/checkout-discount-rule)` *required*

The item at this edge.

**nodes** `[\[CheckoutDiscountRule!\]!](/docs/api-reference/v3/reference/checkout/checkout-discount-rule)` *required*

The nodes in this page, without the edge/cursor wrapper — a convenience over `edges`.

**fields**

**active** `Boolean!` *required*

Whether the rule is evaluated at checkout while discount rules are on.

**conditions** `[CheckoutDiscountRuleConditions!](/docs/api-reference/v3/reference/checkout/checkout-discount-rule-conditions)` *required*

When the rule applies.

**createdAt** `[DateTime!](/docs/api-reference/v3/reference/common/date-time)` *required*

When the rule was created.

**discount** `[CheckoutDiscountRuleDiscount!](/docs/api-reference/v3/reference/checkout/checkout-discount-rule-discount)` *required*

What the rule takes off.

**id** `ID!` *required*

The rule's id.

**message** `String!` *required*

Shopper-facing text shown with the discounted price.

**target** `[CheckoutDiscountRuleTarget!](/docs/api-reference/v3/reference/checkout/checkout-discount-rule-target)` *required*

What the rule discounts.

**updatedAt** `[DateTime!](/docs/api-reference/v3/reference/common/date-time)` *required*

When the rule was last changed.

**pageInfo** `[PageInfo!](/docs/api-reference/v3/pagination)` *required*

Pagination metadata for the current page.

**fields**

**endCursor** `String`

Cursor of the last edge in this page; pass to `after` to page forward.

**hasNextPage** `Boolean!` *required*

Whether more items exist after this page (drives forward pagination with `first`/`after`).

**hasPreviousPage** `Boolean!` *required*

Whether more items exist before this page (drives backward pagination with `last`/`before`).

**startCursor** `String`

Cursor of the first edge in this page; pass to `before` to page backward.

## Example

```graphql theme={null}
query {
  checkoutDiscountRules {
    enabled
    inactiveRules {
      nodes {
        active
        createdAt
        id
        message
        updatedAt
      }
      pageInfo { hasNextPage endCursor }
    }
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.