Choose a version:

giftCardsCount

query

Requires read_gift_cards access scope.

The total number of gift cards issued for the shop. Limited to a maximum of 10000 by default.

Anchor to Arguments

Arguments

Anchor to limitlimit

•Int

Default:10000

The upper bound on count value before returning a result. Use null to have no limit.

Anchor to queryquery

•String

A filter made up of terms, connectives, modifiers, and comparators. You can apply one or more filters to a query. Learn more about Shopify API search syntax.

Anchor to default •string: Filter by a case-insensitive search of multiple fields in a document, including gift card codes.
Anchor to balance_status •string
Anchor to created_at •time
Anchor to expires_on •date
Anchor to id •id: Filter by id range.
Anchor to initial_value •string
Anchor to source •string
Anchor to status •string

Anchor to savedSearchIdsavedSearchId

•ID

The ID of an existing saved search. The search’s query string is used as the query argument. Refer to the SavedSearch object.

Was this section helpful?

Anchor to Possible returnsPossible returns

Anchor to CountCount •Count: A numeric count with precision information indicating whether the count is exact or an estimate.

Was this section helpful?

Examples

Get the total number of enabled gift cards that are issued for the shop

Description

The following query retrieves a count for the total number of enabled gift cards that are issued for the shop.

Query

query {
  giftCardsCount(query: "status:enabled") {
    count
  }
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2025-10/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "query { giftCardsCount(query: \"status:enabled\") { count } }"
}'

React Router

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  const { admin } = await authenticate.admin(request);
  const response = await admin.graphql(
    `#graphql
  query {
    giftCardsCount(query: "status:enabled") {
      count
    }
  }`,
  );
  const json = await response.json();
  return json.data;
}

Ruby

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 {
    giftCardsCount(query: "status:enabled") {
      count
    }
  }
QUERY

response = client.query(query: query)

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: `query {
    giftCardsCount(query: "status:enabled") {
      count
    }
  }`,
});

Response

{
  "giftCardsCount": {
    "count": 10
  }
}

Retrieves a count of gift cards

Description

The following query retrieves a count for the total number of all gift cards that are issued for the shop.

Query

query {
  giftCardsCount {
    count
  }
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2025-10/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "query { giftCardsCount { count } }"
}'

React Router

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  const { admin } = await authenticate.admin(request);
  const response = await admin.graphql(
    `#graphql
  query {
    giftCardsCount {
      count
    }
  }`,
  );
  const json = await response.json();
  return json.data;
}

Ruby

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 {
    giftCardsCount {
      count
    }
  }
QUERY

response = client.query(query: query)

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: `query {
    giftCardsCount {
      count
    }
  }`,
});

Response

{
  "giftCardsCount": {
    "count": 11
  }
}

Examples

Open in GraphiQL

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {

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

const response = await admin.graphql(

`#graphql

query {

giftCardsCount(query: "status:enabled") {

count

}

}`,

);

const json = await response.json();

return json.data;

}

GQL

query {
  giftCardsCount(query: "status:enabled") {
    count
  }
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2025-10/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "query { giftCardsCount(query: \"status:enabled\") { count } }"
}'

React Router

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  const { admin } = await authenticate.admin(request);
  const response = await admin.graphql(
    `#graphql
  query {
    giftCardsCount(query: "status:enabled") {
      count
    }
  }`,
  );
  const json = await response.json();
  return json.data;
}

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: `query {
    giftCardsCount(query: "status:enabled") {
      count
    }
  }`,
});

Ruby

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 {
    giftCardsCount(query: "status:enabled") {
      count
    }
  }
QUERY

response = client.query(query: query)

Response

JSON

{

"giftCardsCount": {

"count": 10

}