> ## 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.

# discountOffers

> The store's discount offers, in the order the Commerce Agent tries them.

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

## Arguments

**after** `String`

Forward pagination cursor — returns offers after it.

**before** `String`

Backward pagination cursor — returns offers before it.

**first** `Int`

Forward pagination: returns the first N offers (max 100, default 25). Use with `after`; mutually exclusive with `last`/`before`.

**last** `Int`

Backward pagination: returns the last N offers (max 100, default 25). Use with `before`; mutually exclusive with `first`/`after`.

## Returns

**discountOffers** `[DiscountOfferConnection!](/docs/api-reference/v3/pagination)` *required*

A paginated list of DiscountOffer items.

**fields**

**edges** `[\[DiscountOfferEdge!\]!](/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** `[DiscountOffer!](/docs/api-reference/v3/reference/commerce-agent/discount-offer)` *required*

The item at this edge.

**fields**

**audience** `[DiscountOfferAudience!](/docs/api-reference/v3/reference/commerce-agent/discount-offer-audience)` *required*

Who the offer is for.

**cartConditions** `[DiscountOfferCartConditions](/docs/api-reference/v3/reference/commerce-agent/discount-offer-cart-conditions)`

Which carts the offer is for. Null means any cart. An offer with conditions needs a live cart to match.

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

When the offer was added.

**discounts** `[\[DiscountOfferDiscount!\]!](/docs/api-reference/v3/reference/commerce-agent/discount-offer-discount)` *required*

The discounts the offer gives. With more than one, shoppers are split across them by weight. A deleted discount is left out.

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

When the offer ends (exclusive). Null means it doesn't.

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

The id of this offer.

**name** `String!` *required*

The merchant's name for the offer.

**paused** `Boolean!` *required*

A paused offer is skipped.

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

When the offer starts. Null means it already has.

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

When the offer last changed.

**nodes** `[\[DiscountOffer!\]!](/docs/api-reference/v3/reference/commerce-agent/discount-offer)` *required*

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

**fields**

**audience** `[DiscountOfferAudience!](/docs/api-reference/v3/reference/commerce-agent/discount-offer-audience)` *required*

Who the offer is for.

**cartConditions** `[DiscountOfferCartConditions](/docs/api-reference/v3/reference/commerce-agent/discount-offer-cart-conditions)`

Which carts the offer is for. Null means any cart. An offer with conditions needs a live cart to match.

**fields**

**blocks** `[\[DiscountOfferCartConditionBlock!\]!](/docs/api-reference/v3/reference/commerce-agent/discount-offer-cart-condition-block)` *required*

Groups of conditions, at least one.

**conjunction** `[Conjunction!](/docs/api-reference/v3/reference/common/conjunction)` *required*

How the blocks combine.

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

When the offer was added.

**discounts** `[\[DiscountOfferDiscount!\]!](/docs/api-reference/v3/reference/commerce-agent/discount-offer-discount)` *required*

The discounts the offer gives. With more than one, shoppers are split across them by weight. A deleted discount is left out.

**fields**

**discountCode** `[DiscountCode!](/docs/api-reference/v3/reference/marketing/discount-code)` *required*

The discount.

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

**weight** `Int!` *required*

This discount's share of the offer's shoppers, relative to the other discounts' weights.

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

When the offer ends (exclusive). Null means it doesn't.

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

The id of this offer.

**name** `String!` *required*

The merchant's name for the offer.

**paused** `Boolean!` *required*

A paused offer is skipped.

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

When the offer starts. Null means it already has.

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

When the offer 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 {
  discountOffers(after: "...", before: "...", first: 10, last: 10) {
    nodes {
      createdAt
      endsAt
      id
      name
      paused
      startsAt
      updatedAt
    }
    pageInfo { hasNextPage endCursor }
  }
}
```


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