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

# DiscountOffer

> One row of the store's discount offer list. The Commerce Agent offers a shopper the first offer, top to bottom, whose audience, cart conditions and window they match.

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

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

**fields**

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

The conditions in this block.

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

How the conditions in this block combine.

**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)

**fields**

**code** `String!` *required*

The code customers enter at checkout.

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

When the discount was created.

**description** `String!` *required*

A short human-readable summary of what the code does.

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

When this code stops working.

**externalId** `String!` *required*

The platform's id for this discount (a Shopify GID or a BigCommerce promotion id).

**groupType** `[DiscountCodeGroupType!](/docs/api-reference/v3/reference/marketing/discount-code-group-type)` *required*

Whether this is one fixed code or a unique code per customer.

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

The id of this discount code.

**kind** `[DiscountCodeKind](/docs/api-reference/v3/reference/marketing/discount-code-kind)`

How the discount reduces the order. Null when the config has no settings type.

**legacyId** `String!` *required*

The discount's legacy Mongo ObjectId (24-char hex) from before the CockroachDB migration.

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

The commerce platform that hosts this code.

**settings** `[DiscountCodeSettings](/docs/api-reference/v3/reference/marketing/discount-code-settings)`

How the discount reduces the order.

**title** `String!` *required*

The merchant-facing name of the discount.

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

When the discount was last edited.

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


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