openapi: 3.1.0
info:
  title: Shopify Admin REST About Published API
  description: The Shopify Admin REST API lets you build apps and integrations that extend and enhance the Shopify admin. Access products, customers, orders, inventory, fulfillment, and more. Endpoints are organized by resource type and versioned by release date.
  version: 2025-01
  contact:
    name: Shopify
    url: https://shopify.dev/docs/api/admin-rest
    email: api@shopify.com
  license:
    name: Shopify API Terms
    url: https://www.shopify.com/legal/api-terms
  x-date: '2026-03-04'
servers:
- url: https://{store}.myshopify.com/admin/api/2025-01
  description: Shopify Admin REST API
  variables:
    store:
      default: my-store
      description: The Shopify store subdomain
security:
- AccessToken: []
tags:
- name: Published
paths:
  /admin/api/2020-01/collection_listings.json:
    get:
      summary: Shopify Retrieve Collection Listings That Are Published To Your App
      description: https://shopify.dev/docs/admin-api/rest/reference/sales-channels/collectionlisting#index-2020-01
      parameters:
      - in: query
        name: limit
        description: "Amount of results\n                  (default: 50, maximum: 1000)"
        schema: {}
        required: false
      tags:
      - Published
      responses:
        '200':
          description: ''
      operationId: deprecated_202001_get_collection_listings
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/2020-01/collection_listings/{collection_listing_id}/product_ids.json:
    get:
      summary: Shopify Retrieve Product_ids That Are Published To A Collection_id
      description: https://shopify.dev/docs/admin-api/rest/reference/sales-channels/collectionlisting#product_ids-2020-01
      parameters:
      - in: path
        name: collection_listing_id
        required: true
        schema:
          type: string
        description: collection_listing_id
      - in: query
        name: limit
        description: "Amount of results\n                  (default: 50, maximum: 1000)"
        schema: {}
        required: false
      tags:
      - Published
      responses:
        '200':
          description: ''
      operationId: deprecated_202001_get_collection_listings_param_collection_listing_id_product_ids
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/2020-01/collection_listings/{collection_listing_id}.json:
    get:
      summary: Shopify Retrieve A Specific Collection Listing That Is Published To Your App
      description: https://shopify.dev/docs/admin-api/rest/reference/sales-channels/collectionlisting#show-2020-01
      parameters:
      - in: path
        name: collection_listing_id
        required: true
        schema:
          type: string
        description: collection_listing_id
      tags:
      - Published
      responses:
        '200':
          description: ''
      operationId: deprecated_202001_get_collection_listings_param_collection_listing_id
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/2020-04/collection_listings.json:
    get:
      summary: Shopify Retrieve Collection Listings That Are Published To Your App
      description: https://shopify.dev/docs/admin-api/rest/reference/sales-channels/collectionlisting#index-2020-04
      parameters:
      - in: query
        name: limit
        description: "Amount of results\n                  (default: 50, maximum: 1000)"
        schema: {}
        required: false
      tags:
      - Published
      responses:
        '200':
          description: ''
      operationId: deprecated_202004_get_collection_listings
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/2020-04/collection_listings/{collection_listing_id}/product_ids.json:
    get:
      summary: Shopify Retrieve Product_ids That Are Published To A Collection_id
      description: https://shopify.dev/docs/admin-api/rest/reference/sales-channels/collectionlisting#product_ids-2020-04
      parameters:
      - in: path
        name: collection_listing_id
        required: true
        schema:
          type: string
        description: collection_listing_id
      - in: query
        name: limit
        description: "Amount of results\n                  (default: 50, maximum: 1000)"
        schema: {}
        required: false
      tags:
      - Published
      responses:
        '200':
          description: ''
      operationId: deprecated_202004_get_collection_listings_param_collection_listing_id_product_ids
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/2020-04/collection_listings/{collection_listing_id}.json:
    get:
      summary: Shopify Retrieve A Specific Collection Listing That Is Published To Your App
      description: https://shopify.dev/docs/admin-api/rest/reference/sales-channels/collectionlisting#show-2020-04
      parameters:
      - in: path
        name: collection_listing_id
        required: true
        schema:
          type: string
        description: collection_listing_id
      tags:
      - Published
      responses:
        '200':
          description: ''
      operationId: deprecated_202004_get_collection_listings_param_collection_listing_id
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/2020-07/collection_listings.json:
    get:
      summary: Shopify Retrieve Collection Listings That Are Published To Your App
      description: https://shopify.dev/docs/admin-api/rest/reference/sales-channels/collectionlisting#index-2020-07
      parameters:
      - in: query
        name: limit
        description: "Amount of results\n                  (default: 50, maximum: 1000)"
        schema: {}
        required: false
      tags:
      - Published
      responses:
        '200':
          description: ''
      operationId: deprecated_202007_get_collection_listings
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/2020-07/collection_listings/{collection_listing_id}/product_ids.json:
    get:
      summary: Shopify Retrieve Product_ids That Are Published To A Collection_id
      description: https://shopify.dev/docs/admin-api/rest/reference/sales-channels/collectionlisting#product_ids-2020-07
      parameters:
      - in: path
        name: collection_listing_id
        required: true
        schema:
          type: string
        description: collection_listing_id
      - in: query
        name: limit
        description: "Amount of results\n                  (default: 50, maximum: 1000)"
        schema: {}
        required: false
      tags:
      - Published
      responses:
        '200':
          description: ''
      operationId: deprecated_202007_get_collection_listings_param_collection_listing_id_product_ids
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/2020-07/collection_listings/{collection_listing_id}.json:
    get:
      summary: Shopify Retrieve A Specific Collection Listing That Is Published To Your App
      description: https://shopify.dev/docs/admin-api/rest/reference/sales-channels/collectionlisting#show-2020-07
      parameters:
      - in: path
        name: collection_listing_id
        required: true
        schema:
          type: string
        description: collection_listing_id
      tags:
      - Published
      responses:
        '200':
          description: ''
      operationId: deprecated_202007_get_collection_listings_param_collection_listing_id
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/2020-10/collection_listings.json:
    get:
      summary: Shopify Retrieve Collection Listings That Are Published To Your App
      description: https://shopify.dev/docs/admin-api/rest/reference/sales-channels/collectionlisting#index-2020-10
      parameters:
      - in: query
        name: limit
        description: "Amount of results\n                  (default: 50, maximum: 1000)"
        schema: {}
        required: false
      tags:
      - Published
      responses:
        '200':
          description: ''
      operationId: get_collection_listings
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/2020-10/collection_listings/{collection_listing_id}/product_ids.json:
    get:
      summary: Shopify Retrieve Product_ids That Are Published To A Collection_id
      description: https://shopify.dev/docs/admin-api/rest/reference/sales-channels/collectionlisting#product_ids-2020-10
      parameters:
      - in: path
        name: collection_listing_id
        required: true
        schema:
          type: string
        description: collection_listing_id
      - in: query
        name: limit
        description: "Amount of results\n                  (default: 50, maximum: 1000)"
        schema: {}
        required: false
      tags:
      - Published
      responses:
        '200':
          description: ''
      operationId: get_collection_listings_param_collection_listing_id_product_ids
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/2020-10/collection_listings/{collection_listing_id}.json:
    get:
      summary: Shopify Retrieve A Specific Collection Listing That Is Published To Your App
      description: https://shopify.dev/docs/admin-api/rest/reference/sales-channels/collectionlisting#show-2020-10
      parameters:
      - in: path
        name: collection_listing_id
        required: true
        schema:
          type: string
        description: collection_listing_id
      tags:
      - Published
      responses:
        '200':
          description: ''
      operationId: get_collection_listings_param_collection_listing_id
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/2021-01/collection_listings.json:
    get:
      summary: Shopify Retrieve Collection Listings That Are Published To Your App
      description: https://shopify.dev/docs/admin-api/rest/reference/sales-channels/collectionlisting#index-2021-01
      parameters:
      - in: query
        name: limit
        description: "Amount of results\n                  (default: 50, maximum: 1000)"
        schema: {}
        required: false
      tags:
      - Published
      responses:
        '200':
          description: ''
      operationId: deprecated_202101_get_collection_listings
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/2021-01/collection_listings/{collection_listing_id}/product_ids.json:
    get:
      summary: Shopify Retrieve Product_ids That Are Published To A Collection_id
      description: https://shopify.dev/docs/admin-api/rest/reference/sales-channels/collectionlisting#product_ids-2021-01
      parameters:
      - in: path
        name: collection_listing_id
        required: true
        schema:
          type: string
        description: collection_listing_id
      - in: query
        name: limit
        description: "Amount of results\n                  (default: 50, maximum: 1000)"
        schema: {}
        required: false
      tags:
      - Published
      responses:
        '200':
          description: ''
      operationId: deprecated_202101_get_collection_listings_param_collection_listing_id_product_ids
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/2021-01/collection_listings/{collection_listing_id}.json:
    get:
      summary: Shopify Retrieve A Specific Collection Listing That Is Published To Your App
      description: https://shopify.dev/docs/admin-api/rest/reference/sales-channels/collectionlisting#show-2021-01
      parameters:
      - in: path
        name: collection_listing_id
        required: true
        schema:
          type: string
        description: collection_listing_id
      tags:
      - Published
      responses:
        '200':
          description: ''
      operationId: deprecated_202101_get_collection_listings_param_collection_listing_id
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/unstable/collection_listings.json:
    get:
      summary: Shopify Retrieve Collection Listings That Are Published To Your App
      description: https://shopify.dev/docs/admin-api/rest/reference/sales-channels/collectionlisting#index-unstable
      parameters:
      - in: query
        name: limit
        description: "Amount of results\n                  (default: 50, maximum: 1000)"
        schema: {}
        required: false
      tags:
      - Published
      responses:
        '200':
          description: ''
      operationId: deprecated_unstable_get_collection_listings
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/unstable/collection_listings/{collection_listing_id}/product_ids.json:
    get:
      summary: Shopify Retrieve Product_ids That Are Published To A Collection_id
      description: https://shopify.dev/docs/admin-api/rest/reference/sales-channels/collectionlisting#product_ids-unstable
      parameters:
      - in: path
        name: collection_listing_id
        required: true
        schema:
          type: string
        description: collection_listing_id
      - in: query
        name: limit
        description: "Amount of results\n                  (default: 50, maximum: 1000)"
        schema: {}
        required: false
      tags:
      - Published
      responses:
        '200':
          description: ''
      operationId: deprecated_unstable_get_collection_listings_param_collection_listing_id_product_ids
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/unstable/collection_listings/{collection_listing_id}.json:
    get:
      summary: Shopify Retrieve A Specific Collection Listing That Is Published To Your App
      description: https://shopify.dev/docs/admin-api/rest/reference/sales-channels/collectionlisting#show-unstable
      parameters:
      - in: path
        name: collection_listing_id
        required: true
        schema:
          type: string
        description: collection_listing_id
      tags:
      - Published
      responses:
        '200':
          description: ''
      operationId: deprecated_unstable_get_collection_listings_param_collection_listing_id
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/2020-01/product_listings.json:
    get:
      summary: Shopify Retrieve Product Listings That Are Published To Your App
      description: https://shopify.dev/docs/admin-api/rest/reference/sales-channels/productlisting#index-2020-01
      parameters:
      - in: query
        name: product_ids
        description: A comma-separated list of product ids
        schema: {}
        required: false
      - in: query
        name: limit
        description: "Amount of results\n                  (default: 50, maximum: 1000)"
        schema: {}
        required: false
      - in: query
        name: collection_id
        description: Filter by products belonging to a particular collection
        schema: {}
        required: false
      - in: query
        name: updated_at_min
        description: Filter by products last updated after a certain date and time (formatted in ISO 8601)
        schema: {}
        required: false
      - in: query
        name: handle
        description: Filter by product handle
        schema: {}
        required: false
      tags:
      - Published
      responses:
        '200':
          description: ''
      operationId: deprecated_202001_get_product_listings
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/2020-01/product_listings/product_ids.json:
    get:
      summary: Shopify Retrieve Product_ids That Are Published To Your App
      description: https://shopify.dev/docs/admin-api/rest/reference/sales-channels/productlisting#product_ids-2020-01
      parameters:
      - in: query
        name: limit
        description: "Amount of results\n                  (default: 50, maximum: 1000)"
        schema: {}
        required: false
      tags:
      - Published
      responses:
        '200':
          description: ''
      operationId: deprecated_202001_get_product_listings_product_ids
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/2020-01/product_listings/count.json:
    get:
      summary: Shopify Retrieve A Count Of Products That Are Published To Your App
      description: https://shopify.dev/docs/admin-api/rest/reference/sales-channels/productlisting#count-2020-01
      parameters: []
      tags:
      - Published
      responses:
        '200':
          description: ''
      operationId: deprecated_202001_get_product_listings_count
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/2020-01/product_listings/{product_listing_id}.json:
    get:
      summary: Shopify Retrieve A Specific Product Listing That Is Published To Your App
      description: https://shopify.dev/docs/admin-api/rest/reference/sales-channels/productlisting#show-2020-01
      parameters:
      - in: path
        name: product_listing_id
        required: true
        schema:
          type: string
        description: product_listing_id
      tags:
      - Published
      responses:
        '200':
          description: ''
      operationId: deprecated_202001_get_product_listings_param_product_listing_id
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/2020-04/product_listings.json:
    get:
      summary: Shopify Retrieve Product Listings That Are Published To Your App
      description: https://shopify.dev/docs/admin-api/rest/reference/sales-channels/productlisting#index-2020-04
      parameters:
      - in: query
        name: product_ids
        description: A comma-separated list of product ids
        schema: {}
        required: false
      - in: query
        name: limit
        description: "Amount of results\n                  (default: 50, maximum: 1000)"
        schema: {}
        required: false
      - in: query
        name: collection_id
        description: Filter by products belonging to a particular collection
        schema: {}
        required: false
      - in: query
        name: updated_at_min
        description: Filter by products last updated after a certain date and time (formatted in ISO 8601)
        schema: {}
        required: false
      - in: query
        name: handle
        description: Filter by product handle
        schema: {}
        required: false
      tags:
      - Published
      responses:
        '200':
          description: ''
      operationId: deprecated_202004_get_product_listings
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/2020-04/product_listings/product_ids.json:
    get:
      summary: Shopify Retrieve Product_ids That Are Published To Your App
      description: https://shopify.dev/docs/admin-api/rest/reference/sales-channels/productlisting#product_ids-2020-04
      parameters:
      - in: query
        name: limit
        description: "Amount of results\n                  (default: 50, maximum: 1000)"
        schema: {}
        required: false
      tags:
      - Published
      responses:
        '200':
          description: ''
      operationId: deprecated_202004_get_product_listings_product_ids
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/2020-04/product_listings/count.json:
    get:
      summary: Shopify Retrieve A Count Of Products That Are Published To Your App
      description: https://shopify.dev/docs/admin-api/rest/reference/sales-channels/productlisting#count-2020-04
      parameters: []
      tags:
      - Published
      responses:
        '200':
          description: ''
      operationId: deprecated_202004_get_product_listings_count
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/2020-04/product_listings/{product_listing_id}.json:
    get:
      summary: Shopify Retrieve A Specific Product Listing That Is Published To Your App
      description: https://shopify.dev/docs/admin-api/rest/reference/sales-channels/productlisting#show-2020-04
      parameters:
      - in: path
        name: product_listing_id
        required: true
        schema:
          type: string
        description: product_listing_id
      tags:
      - Published
      responses:
        '200':
          description: ''
      operationId: deprecated_202004_get_product_listings_param_product_listing_id
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/2020-07/product_listings.json:
    get:
      summary: Shopify Retrieve Product Listings That Are Published To Your App
      description: https://shopify.dev/docs/admin-api/rest/reference/sales-channels/productlisting#index-2020-07
      parameters:
      - in: query
        name: product_ids
        description: A comma-separated list of product ids
        schema: {}
        required: false
      - in: query
        name: limit
        description: "Amount of results\n                  (default: 50, maximum: 1000)"
        schema: {}
        required: false
      - in: query
        name: collection_id
        description: Filter by products belonging to a particular collection
        schema: {}
        required: false
      - in: query
        name: updated_at_min
        description: Filter by products last updated after a certain date and time (formatted in ISO 8601)
        schema: {}
        required: false
      - in: query
        name: handle
        description: Filter by product handle
        schema: {}
        required: false
      tags:
      - Published
      responses:
        '200':
          description: ''
      operationId: deprecated_202007_get_product_listings
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/2020-07/product_listings/product_ids.json:
    get:
      summary: Shopify Retrieve Product_ids That Are Published To Your App
      description: https://shopify.dev/docs/admin-api/rest/reference/sales-channels/productlisting#product_ids-2020-07
      parameters:
      - in: query
        name: limit
        description: "Amount of results\n                  (default: 50, maximum: 1000)"
        schema: {}
        required: false
      tags:
      - Published
      responses:
        '200':
          description: ''
      operationId: deprecated_202007_get_product_listings_product_ids
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/2020-07/product_listings/count.json:
    get:
      summary: Shopify Retrieve A Count Of Products That Are Published To Your App
      description: https://shopify.dev/docs/admin-api/rest/reference/sales-channels/productlisting#count-2020-07
      parameters: []
      tags:
      - Published
      responses:
        '200':
          description: ''
      operationId: deprecated_202007_get_product_listings_count
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
  /admin/api/2020-07/product_listings/{product_listing_id}.json:
    get:
      summary: Shopify Retrieve A Specific Product Listing That Is Published To Your App
      description: https://shopify.dev/docs/admin-api/rest/reference/sales-channels/productlisting#show-2020-07
      parameters:
      - in: path
        name: product_listing_id
        required: true
        schema:
          type: string
        description: product_listing_id
      tags:
      - Published
      responses:
        '200':
          description: ''
      operationId: deprecated_202007_get_product_listings_param_product_listing_id
      x-api-evangelist-processing:
        PascalCaseOperationSummaries: true
        ChooseTags: true
components:
  securitySchemes:
    AccessToken:
      type: apiKey
      name: X-Shopify-Access-Token
      in: header
      description: Access token obtained via OAuth