---
title: DiscountRedeemCode - GraphQL Admin
description: >-
  A code that a customer can use at checkout to receive a discount. For example,
  a customer can use the redeem code 'SUMMER20' at checkout to receive a 20%
  discount on their entire order.
api_version: 2024-10
api_name: admin
type: object
api_type: graphql
source_url:
  html: >-
    https://shopify.dev/docs/api/admin-graphql/2024-10/objects/DiscountRedeemCode
  md: >-
    https://shopify.dev/docs/api/admin-graphql/2024-10/objects/DiscountRedeemCode.txt
---

# Discount​Redeem​Code

object

Requires Apps must have `read_discounts` access scope.

A code that a customer can use at checkout to receive a discount. For example, a customer can use the redeem code 'SUMMER20' at checkout to receive a 20% discount on their entire order.

## Fields

* async​Usage​Count

  [Int!](https://shopify.dev/docs/api/admin-graphql/2024-10/scalars/Int)

  non-null

  The number of times that the discount redeem code has been used. This value is updated asynchronously and can be different than the actual usage count.

* code

  [String!](https://shopify.dev/docs/api/admin-graphql/2024-10/scalars/String)

  non-null

  The code that a customer can use at checkout to receive a discount.

* created​By

  [App](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/App)

  The application that created the discount redeem code.

* id

  [ID!](https://shopify.dev/docs/api/admin-graphql/2024-10/scalars/ID)

  non-null

  A globally-unique ID of the discount redeem code.

***

## Map

### Fields and connections with this object

* {}[DiscountCodeApp.codes](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/DiscountCodeApp#field-codes)
* {}[DiscountCodeBasic.codes](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/DiscountCodeBasic#field-codes)
* {}[DiscountCodeBxgy.codes](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/DiscountCodeBxgy#field-codes)
* {}[DiscountCodeFreeShipping.codes](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/DiscountCodeFreeShipping#field-codes)
* {}[DiscountRedeemCodeBulkCreationCode.discountRedeemCode](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/DiscountRedeemCodeBulkCreationCode#field-discountRedeemCode)
* <->[DiscountRedeemCodeConnection.nodes](https://shopify.dev/docs/api/admin-graphql/2024-10/connections/DiscountRedeemCodeConnection#field-nodes)
* {}[DiscountRedeemCodeEdge.node](https://shopify.dev/docs/api/admin-graphql/2024-10/objects/DiscountRedeemCodeEdge#field-node)