priceList

query

Returns a price list resource by ID.

Arguments

Anchor to idid • ID!required: The ID of the PriceList to return.

Was this section helpful?

Anchor to Possible returnsPossible returns

Anchor to PriceListPriceList • PriceList: Represents a price list, including information about related prices and eligibility rules. You can use price lists to specify either fixed prices or adjusted relative prices that override initial product variant prices. Price lists are applied to customers using context rules, which determine price list eligibility.

For more information on price lists, refer to Support different pricing models.

Was this section helpful?

Retrieve Price List Details and Associated Catalog Information
Retrieve Quantity Rules on Price List
Retrieve the FIXED prices on a price list
Retrieve the prices on a price list filtered by product_id
Retrieve the prices on a price list filtered by variant_id

Examples

1const { admin } = await authenticate.admin(request);
2
3const response = await admin.graphql(
4  `#graphql
5  query {
6    priceList(id: "gid://shopify/PriceList/524058083") {
7      catalog {
8        id
9        title
10      }
11      prices(first: 5, query: "product_id:20995642") {
12        nodes {
13          price {
14            amount
15            currencyCode
16          }
17          variant {
18            id
19          }
20        }
21      }
22      currency
23      parent {
24        adjustment {
25          type
26          value
27        }
28      }
29    }
30  }`,
31);
32
33const data = await response.json();
34

query {
  priceList(id: "gid://shopify/PriceList/524058083") {
    catalog {
      id
      title
    }
    prices(first: 5, query: "product_id:20995642") {
      nodes {
        price {
          amount
          currencyCode
        }
        variant {
          id
        }
      }
    }
    currency
    parent {
      adjustment {
        type
        value
      }
    }
  }
}

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2025-04/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "query { priceList(id: \"gid://shopify/PriceList/524058083\") { catalog { id title } prices(first: 5, query: \"product_id:20995642\") { nodes { price { amount currencyCode } variant { id } } } currency parent { adjustment { type value } } } }"
}'

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

const response = await admin.graphql(
  `#graphql
  query {
    priceList(id: "gid://shopify/PriceList/524058083") {
      catalog {
        id
        title
      }
      prices(first: 5, query: "product_id:20995642") {
        nodes {
          price {
            amount
            currencyCode
          }
          variant {
            id
          }
        }
      }
      currency
      parent {
        adjustment {
          type
          value
        }
      }
    }
  }`,
);

const data = await response.json();

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: `query {
    priceList(id: "gid://shopify/PriceList/524058083") {
      catalog {
        id
        title
      }
      prices(first: 5, query: "product_id:20995642") {
        nodes {
          price {
            amount
            currencyCode
          }
          variant {
            id
          }
        }
      }
      currency
      parent {
        adjustment {
          type
          value
        }
      }
    }
  }`,
});

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 {
    priceList(id: "gid://shopify/PriceList/524058083") {
      catalog {
        id
        title
      }
      prices(first: 5, query: "product_id:20995642") {
        nodes {
          price {
            amount
            currencyCode
          }
          variant {
            id
          }
        }
      }
      currency
      parent {
        adjustment {
          type
          value
        }
      }
    }
  }
QUERY

response = client.query(query: query)

Response

JSON

1{
2  "priceList": {
3    "catalog": {
4      "id": "gid://shopify/MarketCatalog/307400570",
5      "title": "Just a simple catalog for a US Price List"
6    },
7    "prices": {
8      "nodes": [
9        {
10          "price": {
11            "amount": "9.0",
12            "currencyCode": "USD"
13          },
14          "variant": {
15            "id": "gid://shopify/ProductVariant/30322695"
16          }
17        },
18        {
19          "price": {
20            "amount": "13.5",
21            "currencyCode": "USD"
22          },
23          "variant": {
24            "id": "gid://shopify/ProductVariant/113711323"
25          }
26        },
27        {
28          "price": {
29            "amount": "13.5",
30            "currencyCode": "USD"
31          },
32          "variant": {
33            "id": "gid://shopify/ProductVariant/236948360"
34          }
35        }
36      ]
37    },
38    "currency": "USD",
39    "parent": {
40      "adjustment": {
41        "type": "PERCENTAGE_DECREASE",
42        "value": 10
43      }
44    }
45  }
46}