Choose a version:

priceList

query

Returns a PriceList by ID. You can use price lists to specify either fixed prices or adjusted relative prices that override initial Product prices.

Price lists enable contextual pricing for the Catalog they are associated to. Each price list can define fixed prices for specific ProductVariant objects or percentage-based adjustments relative to other prices.

Anchor to Arguments

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

A list that defines pricing for product variants. Price lists override default product prices with either fixed prices or percentage-based adjustments.

Each price list associates with a Catalog to determine which customers see the pricing. The catalog's context rules control when the price list applies, such as for specific markets, company locations, or apps.

Learn how to support different pricing models.

Anchor to catalogcatalog

•Catalog

The catalog that the price list is associated with.

Anchor to currencycurrency

•CurrencyCode!

non-null

The currency for fixed prices associated with this price list.

Anchor to fixedPricesCountfixedPricesCount

•Int!

non-null

The number of fixed prices on the price list.

Anchor to idid

•ID!

non-null

A globally-unique ID.

Anchor to namename

•String!

non-null

The unique name of the price list, used as a human-readable identifier.

Anchor to parentparent

•PriceListParent

Relative adjustments to other prices.

Anchor to pricesprices

•PriceListPriceConnection!

non-null

A list of prices associated with the price list.

Arguments

Anchor to originTypeoriginType

•PriceListPriceOriginType

The origin of this price, either fixed (defined on the price list) or relative (calculated using an adjustment via a price list parent configuration).

Anchor to firstfirst

•Int

The first n elements from the paginated list.

Anchor to afterafter

•String

The elements that come after the specified cursor.

Anchor to lastlast

•Int

The last n elements from the paginated list.

Anchor to beforebefore

•String

The elements that come before the specified cursor.

Anchor to reversereverse

•Boolean

Default:false

Reverse the order of the underlying list.

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 id •id: Filter by id range.
Anchor to product_id •id
Anchor to variant_id •id

Anchor to quantityRulesquantityRules

•QuantityRuleConnection!

non-null

A list of quantity rules associated with the price list, ordered by product variants.

Arguments

Anchor to originTypeoriginType

•QuantityRuleOriginType

Whether the quantity rule is fixed (defined on the price list) or relative (the default quantity rule for the shop).

Anchor to firstfirst

•Int

The first n elements from the paginated list.

Anchor to afterafter

•String

The elements that come after the specified cursor.

Anchor to lastlast

•Int

The last n elements from the paginated list.

Anchor to beforebefore

•String

The elements that come before the specified cursor.

Anchor to reversereverse

•Boolean

Default:false

Reverse the order of the underlying list.

Was this section helpful?

Examples

Retrieve Price List Details and Associated Catalog Information

Description

Retrieves the price list's catalog title. Fetches the currency used in the price list and details about the parent's adjustment type and value.

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
      }
    }
  }
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-01/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 } } } }"
}'

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

Node.js

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
        }
      }
    }
  }`,
});

Response

{
  "priceList": {
    "catalog": {
      "id": "gid://shopify/MarketCatalog/307400570",
      "title": "Just a simple catalog for a US Price List"
    },
    "prices": {
      "nodes": [
        {
          "price": {
            "amount": "9.0",
            "currencyCode": "USD"
          },
          "variant": {
            "id": "gid://shopify/ProductVariant/30322695"
          }
        },
        {
          "price": {
            "amount": "13.5",
            "currencyCode": "USD"
          },
          "variant": {
            "id": "gid://shopify/ProductVariant/113711323"
          }
        },
        {
          "price": {
            "amount": "13.5",
            "currencyCode": "USD"
          },
          "variant": {
            "id": "gid://shopify/ProductVariant/236948360"
          }
        }
      ]
    },
    "currency": "USD",
    "parent": {
      "adjustment": {
        "type": "PERCENTAGE_DECREASE",
        "value": 10
      }
    }
  }
}

Retrieve Quantity Rules on Price List

Description

Retrieves the fixed associated quantity rules on a price list.

Query

query {
  priceList(id: "gid://shopify/PriceList/225060712") {
    quantityRules(first: 3, originType: FIXED) {
      nodes {
        increment
        maximum
        minimum
        productVariant {
          id
          title
        }
      }
    }
    currency
  }
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-01/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "query { priceList(id: \"gid://shopify/PriceList/225060712\") { quantityRules(first: 3, originType: FIXED) { nodes { increment maximum minimum productVariant { id title } } } currency } }"
}'

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 {
    priceList(id: "gid://shopify/PriceList/225060712") {
      quantityRules(first: 3, originType: FIXED) {
        nodes {
          increment
          maximum
          minimum
          productVariant {
            id
            title
          }
        }
      }
      currency
    }
  }`,
  );
  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 {
    priceList(id: "gid://shopify/PriceList/225060712") {
      quantityRules(first: 3, originType: FIXED) {
        nodes {
          increment
          maximum
          minimum
          productVariant {
            id
            title
          }
        }
      }
      currency
    }
  }
QUERY

response = client.query(query: query)

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: `query {
    priceList(id: "gid://shopify/PriceList/225060712") {
      quantityRules(first: 3, originType: FIXED) {
        nodes {
          increment
          maximum
          minimum
          productVariant {
            id
            title
          }
        }
      }
      currency
    }
  }`,
});

Response

{
  "priceList": {
    "quantityRules": {
      "nodes": [
        {
          "increment": 100,
          "maximum": 5000,
          "minimum": 500,
          "productVariant": {
            "id": "gid://shopify/ProductVariant/43729076",
            "title": "151cm"
          }
        },
        {
          "increment": 10,
          "maximum": 1000,
          "minimum": 100,
          "productVariant": {
            "id": "gid://shopify/ProductVariant/138327650",
            "title": "Default"
          }
        },
        {
          "increment": 5,
          "maximum": null,
          "minimum": 10,
          "productVariant": {
            "id": "gid://shopify/ProductVariant/389013007",
            "title": "Small"
          }
        }
      ]
    },
    "currency": "USD"
  }
}

Retrieve the FIXED prices on a price list

Description

Retrieve the first ten fixed prices on a price list, returning the associated price, compareAtPrice, and variant values.

Query

query {
  priceList(id: "gid://shopify/PriceList/294167858") {
    id
    name
    prices(first: 10, originType: FIXED) {
      nodes {
        price {
          amount
          currencyCode
        }
        compareAtPrice {
          amount
          currencyCode
        }
        originType
        variant {
          id
        }
      }
    }
  }
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-01/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "query { priceList(id: \"gid://shopify/PriceList/294167858\") { id name prices(first: 10, originType: FIXED) { nodes { price { amount currencyCode } compareAtPrice { amount currencyCode } originType variant { id } } } } }"
}'

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 {
    priceList(id: "gid://shopify/PriceList/294167858") {
      id
      name
      prices(first: 10, originType: FIXED) {
        nodes {
          price {
            amount
            currencyCode
          }
          compareAtPrice {
            amount
            currencyCode
          }
          originType
          variant {
            id
          }
        }
      }
    }
  }`,
  );
  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 {
    priceList(id: "gid://shopify/PriceList/294167858") {
      id
      name
      prices(first: 10, originType: FIXED) {
        nodes {
          price {
            amount
            currencyCode
          }
          compareAtPrice {
            amount
            currencyCode
          }
          originType
          variant {
            id
          }
        }
      }
    }
  }
QUERY

response = client.query(query: query)

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: `query {
    priceList(id: "gid://shopify/PriceList/294167858") {
      id
      name
      prices(first: 10, originType: FIXED) {
        nodes {
          price {
            amount
            currencyCode
          }
          compareAtPrice {
            amount
            currencyCode
          }
          originType
          variant {
            id
          }
        }
      }
    }
  }`,
});

Response

{
  "priceList": {
    "id": "gid://shopify/PriceList/294167858",
    "name": "simple_pricelist",
    "prices": {
      "nodes": [
        {
          "price": {
            "amount": "19.96",
            "currencyCode": "USD"
          },
          "compareAtPrice": {
            "amount": "24.99",
            "currencyCode": "USD"
          },
          "originType": "FIXED",
          "variant": {
            "id": "gid://shopify/ProductVariant/113711323"
          }
        },
        {
          "price": {
            "amount": "9.99",
            "currencyCode": "USD"
          },
          "compareAtPrice": {
            "amount": "14.99",
            "currencyCode": "USD"
          },
          "originType": "FIXED",
          "variant": {
            "id": "gid://shopify/ProductVariant/498744621"
          }
        }
      ]
    }
  }
}

Retrieve the prices on a price list filtered by product_id

Description

Retrieve the first ten prices on a price list, filtered by product_id, returning the associated price, compareAtPrice, and variant values.

Query

query {
  priceList(id: "gid://shopify/PriceList/294167858") {
    id
    name
    prices(first: 10, query: "product_id:20995642") {
      nodes {
        price {
          amount
          currencyCode
        }
        compareAtPrice {
          amount
          currencyCode
        }
        variant {
          id
          product {
            id
          }
        }
      }
    }
  }
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-01/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "query { priceList(id: \"gid://shopify/PriceList/294167858\") { id name prices(first: 10, query: \"product_id:20995642\") { nodes { price { amount currencyCode } compareAtPrice { amount currencyCode } variant { id product { id } } } } } }"
}'

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 {
    priceList(id: "gid://shopify/PriceList/294167858") {
      id
      name
      prices(first: 10, query: "product_id:20995642") {
        nodes {
          price {
            amount
            currencyCode
          }
          compareAtPrice {
            amount
            currencyCode
          }
          variant {
            id
            product {
              id
            }
          }
        }
      }
    }
  }`,
  );
  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 {
    priceList(id: "gid://shopify/PriceList/294167858") {
      id
      name
      prices(first: 10, query: "product_id:20995642") {
        nodes {
          price {
            amount
            currencyCode
          }
          compareAtPrice {
            amount
            currencyCode
          }
          variant {
            id
            product {
              id
            }
          }
        }
      }
    }
  }
QUERY

response = client.query(query: query)

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: `query {
    priceList(id: "gid://shopify/PriceList/294167858") {
      id
      name
      prices(first: 10, query: "product_id:20995642") {
        nodes {
          price {
            amount
            currencyCode
          }
          compareAtPrice {
            amount
            currencyCode
          }
          variant {
            id
            product {
              id
            }
          }
        }
      }
    }
  }`,
});

Response

{
  "priceList": {
    "id": "gid://shopify/PriceList/294167858",
    "name": "simple_pricelist",
    "prices": {
      "nodes": [
        {
          "price": {
            "amount": "10.0",
            "currencyCode": "USD"
          },
          "compareAtPrice": {
            "amount": "14.0",
            "currencyCode": "USD"
          },
          "variant": {
            "id": "gid://shopify/ProductVariant/30322695",
            "product": {
              "id": "gid://shopify/Product/20995642"
            }
          }
        },
        {
          "price": {
            "amount": "19.96",
            "currencyCode": "USD"
          },
          "compareAtPrice": {
            "amount": "24.99",
            "currencyCode": "USD"
          },
          "variant": {
            "id": "gid://shopify/ProductVariant/113711323",
            "product": {
              "id": "gid://shopify/Product/20995642"
            }
          }
        },
        {
          "price": {
            "amount": "15.0",
            "currencyCode": "USD"
          },
          "compareAtPrice": {
            "amount": "17.0",
            "currencyCode": "USD"
          },
          "variant": {
            "id": "gid://shopify/ProductVariant/236948360",
            "product": {
              "id": "gid://shopify/Product/20995642"
            }
          }
        }
      ]
    }
  }
}

Retrieve the prices on a price list filtered by variant_id

Description

Retrieve the first ten prices on a price list, filtered by variant_id, returning the associated price, compareAtPrice, and variant values.

Query

query {
  priceList(id: "gid://shopify/PriceList/294167858") {
    id
    name
    prices(first: 10, query: "variant_id:498744621") {
      nodes {
        price {
          amount
          currencyCode
        }
        compareAtPrice {
          amount
          currencyCode
        }
        variant {
          id
        }
      }
    }
  }
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-01/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "query { priceList(id: \"gid://shopify/PriceList/294167858\") { id name prices(first: 10, query: \"variant_id:498744621\") { nodes { price { amount currencyCode } compareAtPrice { amount currencyCode } variant { id } } } } }"
}'

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 {
    priceList(id: "gid://shopify/PriceList/294167858") {
      id
      name
      prices(first: 10, query: "variant_id:498744621") {
        nodes {
          price {
            amount
            currencyCode
          }
          compareAtPrice {
            amount
            currencyCode
          }
          variant {
            id
          }
        }
      }
    }
  }`,
  );
  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 {
    priceList(id: "gid://shopify/PriceList/294167858") {
      id
      name
      prices(first: 10, query: "variant_id:498744621") {
        nodes {
          price {
            amount
            currencyCode
          }
          compareAtPrice {
            amount
            currencyCode
          }
          variant {
            id
          }
        }
      }
    }
  }
QUERY

response = client.query(query: query)

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: `query {
    priceList(id: "gid://shopify/PriceList/294167858") {
      id
      name
      prices(first: 10, query: "variant_id:498744621") {
        nodes {
          price {
            amount
            currencyCode
          }
          compareAtPrice {
            amount
            currencyCode
          }
          variant {
            id
          }
        }
      }
    }
  }`,
});

Response

{
  "priceList": {
    "id": "gid://shopify/PriceList/294167858",
    "name": "simple_pricelist",
    "prices": {
      "nodes": [
        {
          "price": {
            "amount": "9.99",
            "currencyCode": "USD"
          },
          "compareAtPrice": {
            "amount": "14.99",
            "currencyCode": "USD"
          },
          "variant": {
            "id": "gid://shopify/ProductVariant/498744621"
          }
        }
      ]
    }
  }
}

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 {

priceList(id: "gid://shopify/PriceList/524058083") {

catalog {

title

}

prices(first: 5, query: "product_id:20995642") {

nodes {

price {

amount

currencyCode

}

variant {

}

currency

parent {

adjustment {

type

value

}

}`,

);

const json = await response.json();

return json.data;

}

GQL

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

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-01/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 } } } }"
}'

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 {
    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 json = await response.json();
  return json.data;
}

Node.js

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
        }
      }
    }
  }`,
});

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 {
    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

{

"priceList": {

"catalog": {

"id": "gid://shopify/MarketCatalog/307400570",

"title": "Just a simple catalog for a US Price List"

"prices": {

"nodes": [

{

"price": {

"amount": "9.0",

"currencyCode": "USD"

"variant": {

"id": "gid://shopify/ProductVariant/30322695"

}

{

"price": {

"amount": "13.5",

"currencyCode": "USD"

"variant": {

"id": "gid://shopify/ProductVariant/113711323"

}

{

"price": {

"amount": "13.5",

"currencyCode": "USD"

"variant": {

"id": "gid://shopify/ProductVariant/236948360"

}

]

"currency": "USD",

"parent": {

"adjustment": {

"type": "PERCENTAGE_DECREASE",

"value": 10

}