Choose a version:

codeDiscountNodeByCode

query

Requires Apps must have read_discounts access scope.

Returns a code discount identified by its discount code.

Arguments

Anchor to codecode • String!required: The case-insensitive code of the DiscountCodeNode to return.

Was this section helpful?

Anchor to Possible returnsPossible returns

DiscountCodeNode

•

DiscountCodeNode

The DiscountCodeNode object enables you to manage code discounts that are applied when customers enter a code at checkout. For example, you can offer discounts where customers have to enter a code to redeem an amount off discount on products, variants, or collections in a store. Or, you can offer discounts where customers have to enter a code to get free shipping. Merchants can create and share discount codes individually with customers.

Learn more about working with Shopify's discount model, including related queries, mutations, limitations, and considerations.

codeDiscount• DiscountCode! non-null: The underlying code discount object.
events • EventConnection! non-null: The paginated list of events associated with the host subject.
id• ID! non-null: A globally-unique ID.
metafield• Metafield: A custom field, including its namespace and key, that's associated with a Shopify resource for the purposes of adding and storing additional information.
metafields • MetafieldConnection! non-null: A list of custom fields that a merchant associates with a Shopify resource.
metafieldDefinitions • MetafieldDefinitionConnection! non-null: List of metafield definitions.

Was this section helpful?

Search for a code discount by discount code

Open in GraphiQL

const { admin } = await authenticate.admin(request);

const response = await admin.graphql(

`#graphql

query codeDiscountNodeByCode($code: String!) {

codeDiscountNodeByCode(code: $code) {

codeDiscount {

__typename

... on DiscountCodeBasic {

codesCount {

count

}

shortSummary

}

}`,

{

variables: {

"code": "DISCOUNTAPPLICATIONSROCKS"

);

const data = await response.json();

query codeDiscountNodeByCode($code: String!) {
  codeDiscountNodeByCode(code: $code) {
    codeDiscount {
      __typename
      ... on DiscountCodeBasic {
        codesCount {
          count
        }
        shortSummary
      }
    }
    id
  }
}

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2025-01/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "query codeDiscountNodeByCode($code: String!) { codeDiscountNodeByCode(code: $code) { codeDiscount { __typename ... on DiscountCodeBasic { codesCount { count } shortSummary } } id } }",
 "variables": {
    "code": "DISCOUNTAPPLICATIONSROCKS"
  }
}'

const { admin } = await authenticate.admin(request);

const response = await admin.graphql(
  `#graphql
  query codeDiscountNodeByCode($code: String!) {
    codeDiscountNodeByCode(code: $code) {
      codeDiscount {
        __typename
        ... on DiscountCodeBasic {
          codesCount {
            count
          }
          shortSummary
        }
      }
      id
    }
  }`,
  {
    variables: {
      "code": "DISCOUNTAPPLICATIONSROCKS"
    },
  },
);

const data = await response.json();

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `query codeDiscountNodeByCode($code: String!) {
      codeDiscountNodeByCode(code: $code) {
        codeDiscount {
          __typename
          ... on DiscountCodeBasic {
            codesCount {
              count
            }
            shortSummary
          }
        }
        id
      }
    }`,
    "variables": {
      "code": "DISCOUNTAPPLICATIONSROCKS"
    },
  },
});

session = ShopifyAPI::Auth::Session.new(
  shop: "your-development-store.myshopify.com",
  access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
  session: session
)

query = <<~QUERY
  query codeDiscountNodeByCode($code: String!) {
    codeDiscountNodeByCode(code: $code) {
      codeDiscount {
        __typename
        ... on DiscountCodeBasic {
          codesCount {
            count
          }
          shortSummary
        }
      }
      id
    }
  }
QUERY

variables = {
  "code": "DISCOUNTAPPLICATIONSROCKS"
}

response = client.query(query: query, variables: variables)

Input variables

JSON

{

"code": "DISCOUNTAPPLICATIONSROCKS"

}

Response

JSON

{

"codeDiscountNodeByCode": {

"codeDiscount": {

"__typename": "DiscountCodeBasic",

"codesCount": {

"count": 1

"shortSummary": "$10.00 off Element (151cm)"

"id": "gid://shopify/DiscountCodeNode/573794601"

}