---
title: priceList - GraphQL Admin
description: Returns a price list resource by ID.
api_version: 2025-10
api_name: admin
type: query
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/admin-graphql/latest/queries/priceList
  md: https://shopify.dev/docs/api/admin-graphql/latest/queries/priceList.md
---

# price​List

query

Returns a price list resource by ID.

## Arguments

* id

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

  required

  The ID of the `PriceList` to return.

***

## Possible returns

* Price​List

  [Price​List](https://shopify.dev/docs/api/admin-graphql/latest/objects/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](https://shopify.dev/apps/internationalization/product-price-lists).

***

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

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

  #### cURL

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

  ```javascript
  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

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

  ```javascript
  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

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

* ### Retrieve Quantity Rules on Price List

  #### Description

  Retrieves the fixed associated quantity rules on a price list.

  #### Query

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

  #### cURL

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

  #### React Router

  ```javascript
  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

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

  ```javascript
  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

  ```json
  {
    "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

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

  #### cURL

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

  ```javascript
  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

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

  ```javascript
  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

  ```json
  {
    "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

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

  #### cURL

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

  ```javascript
  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

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

  ```javascript
  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

  ```json
  {
    "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

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

  #### cURL

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

  ```javascript
  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

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

  ```javascript
  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

  ```json
  {
    "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"
            }
          }
        ]
      }
    }
  }
  ```

[Open in GraphiQL](http://localhost:3457/graphiql?query=query%20%7B%0A%20%20priceList\(id%3A%20%22gid%3A%2F%2Fshopify%2FPriceList%2F524058083%22\)%20%7B%0A%20%20%20%20catalog%20%7B%0A%20%20%20%20%20%20id%0A%20%20%20%20%20%20title%0A%20%20%20%20%7D%0A%20%20%20%20prices\(first%3A%205%2C%20query%3A%20%22product_id%3A20995642%22\)%20%7B%0A%20%20%20%20%20%20nodes%20%7B%0A%20%20%20%20%20%20%20%20price%20%7B%0A%20%20%20%20%20%20%20%20%20%20amount%0A%20%20%20%20%20%20%20%20%20%20currencyCode%0A%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20%20%20variant%20%7B%0A%20%20%20%20%20%20%20%20%20%20id%0A%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20%7D%0A%20%20%20%20%7D%0A%20%20%20%20currency%0A%20%20%20%20parent%20%7B%0A%20%20%20%20%20%20adjustment%20%7B%0A%20%20%20%20%20%20%20%20type%0A%20%20%20%20%20%20%20%20value%0A%20%20%20%20%20%20%7D%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D)

```javascript
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;
}
```

##### 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/2025-10/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

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