Shopify API — Collections

naftiko: 1.0.0-alpha2
info:
  label: Shopify  API — Collections
  description: 'Shopify  API — Collections. 24 operations. Lead operation: Shopify Retrieves A List Of Custom Collections.
    Self-contained Naftiko capability covering one Shopify business surface.'
  tags:
  - Shopify
  - Collections
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    SHOPIFY_API_KEY: SHOPIFY_API_KEY
capability:
  consumes:
  - type: http
    namespace: shopify-collections
    baseUri: ''
    description: Shopify  API — Collections business capability. Self-contained, no shared references.
    resources:
    - name: admin-api-2020-01-custom_collections.json
      path: /admin/api/2020-01/custom_collections.json
      operations:
      - name: deprecated202001getcustomcollections
        method: GET
        description: Shopify Retrieves A List Of Custom Collections
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: limit
          in: query
          type: string
          description: The maximum number of results to retrieve.
        - name: ids
          in: query
          type: string
          description: Show only collections specified by a comma-separated list of IDs.
        - name: since_id
          in: query
          type: string
          description: Restrict results to after the specified ID.
        - name: title
          in: query
          type: string
          description: Show custom collections with a given title.
        - name: product_id
          in: query
          type: string
          description: Show custom collections that include a given product.
        - name: handle
          in: query
          type: string
          description: Filter by custom collection handle.
        - name: updated_at_min
          in: query
          type: string
          description: 'Show custom collections last updated after date (format: 2014-04-25T16:15:47-04:00).'
        - name: updated_at_max
          in: query
          type: string
          description: 'Show custom collections last updated before date (format: 2014-04-25T16:15:47-04:00).'
        - name: published_at_min
          in: query
          type: string
          description: 'Show custom collections published after date (format: 2014-04-25T16:15:47-04:00).'
        - name: published_at_max
          in: query
          type: string
          description: 'Show custom collections published before date (format: 2014-04-25T16:15:47-04:00).'
        - name: published_status
          in: query
          type: string
          description: Show custom collectsion with a given published status.
        - name: fields
          in: query
          type: string
          description: Show only certain fields, specified by a comma-separated list of field names.
    - name: admin-api-2020-01-custom_collections-count.json
      path: /admin/api/2020-01/custom_collections/count.json
      operations:
      - name: deprecated202001getcustomcollectionscount
        method: GET
        description: Shopify Retrieves A Count Of Custom Collections
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: title
          in: query
          type: string
          description: Count custom collections with given title.
        - name: product_id
          in: query
          type: string
          description: Count custom collections that include a given product.
        - name: updated_at_min
          in: query
          type: string
          description: 'Count custom collections last updated after date (format: 2014-04-25T16:15:47-04:00).'
        - name: updated_at_max
          in: query
          type: string
          description: 'Count custom collections last updated before date (format: 2014-04-25T16:15:47-04:00).'
        - name: published_at_min
          in: query
          type: string
          description: 'Count custom collections published after date (format: 2014-04-25T16:15:47-04:00).'
        - name: published_at_max
          in: query
          type: string
          description: 'Count custom collections published before date (format: 2014-04-25T16:15:47-04:00).'
        - name: published_status
          in: query
          type: string
          description: Count custom collections with a given published status.
    - name: admin-api-2020-01-smart_collections.json
      path: /admin/api/2020-01/smart_collections.json
      operations:
      - name: deprecated202001getsmartcollections
        method: GET
        description: Shopify Retrieves A List Of Smart Collections
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: limit
          in: query
          type: string
          description: The number of results to show.
        - name: ids
          in: query
          type: string
          description: Show only the smart collections specified by a comma-separated list of IDs.
        - name: since_id
          in: query
          type: string
          description: Restrict results to after the specified ID.
        - name: title
          in: query
          type: string
          description: Show smart collections with the specified title.
        - name: product_id
          in: query
          type: string
          description: Show smart collections that includes the specified product.
        - name: handle
          in: query
          type: string
          description: Filter results by smart collection handle.
        - name: updated_at_min
          in: query
          type: string
          description: 'Show smart collections last updated after this date. (format: 2014-04-25T16:15:47-04:00)'
        - name: updated_at_max
          in: query
          type: string
          description: 'Show smart collections last updated before this date. (format: 2014-04-25T16:15:47-04:00)'
        - name: published_at_min
          in: query
          type: string
          description: 'Show smart collections published after this date. (format: 2014-04-25T16:15:47-04:00)'
        - name: published_at_max
          in: query
          type: string
          description: 'Show smart collections published before this date. (format: 2014-04-25T16:15:47-04:00)'
        - name: published_status
          in: query
          type: string
          description: Filter results based on the published status of smart collections.
        - name: fields
          in: query
          type: string
          description: Show only certain fields, specified by a comma-separated list of field names.
    - name: admin-api-2020-01-smart_collections-count.json
      path: /admin/api/2020-01/smart_collections/count.json
      operations:
      - name: deprecated202001getsmartcollectionscount
        method: GET
        description: Shopify Retrieves A Count Of Smart Collections
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: title
          in: query
          type: string
          description: Show smart collections with the specified title.
        - name: product_id
          in: query
          type: string
          description: Show smart collections that include the specified product.
        - name: updated_at_min
          in: query
          type: string
          description: 'Show smart collections last updated after this date. (format: 2014-04-25T16:15:47-04:00)'
        - name: updated_at_max
          in: query
          type: string
          description: 'Show smart collections last updated before this date.  (format: 2014-04-25T16:15:47-04:00)'
        - name: published_at_min
          in: query
          type: string
          description: 'Show smart collections published after this date.  (format: 2014-04-25T16:15:47-04:00)'
        - name: published_at_max
          in: query
          type: string
          description: 'Show smart collections published before this date.  (format: 2014-04-25T16:15:47-04:00)'
        - name: published_status
          in: query
          type: string
          description: Filter results based on the published status of smart collections.
    - name: admin-api-2020-04-custom_collections.json
      path: /admin/api/2020-04/custom_collections.json
      operations:
      - name: deprecated202004getcustomcollections
        method: GET
        description: Shopify Retrieves A List Of Custom Collections
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: limit
          in: query
          type: string
          description: The maximum number of results to retrieve.
        - name: ids
          in: query
          type: string
          description: Show only collections specified by a comma-separated list of IDs.
        - name: since_id
          in: query
          type: string
          description: Restrict results to after the specified ID.
        - name: title
          in: query
          type: string
          description: Show custom collections with a given title.
        - name: product_id
          in: query
          type: string
          description: Show custom collections that include a given product.
        - name: handle
          in: query
          type: string
          description: Filter by custom collection handle.
        - name: updated_at_min
          in: query
          type: string
          description: 'Show custom collections last updated after date (format: 2014-04-25T16:15:47-04:00).'
        - name: updated_at_max
          in: query
          type: string
          description: 'Show custom collections last updated before date (format: 2014-04-25T16:15:47-04:00).'
        - name: published_at_min
          in: query
          type: string
          description: 'Show custom collections published after date (format: 2014-04-25T16:15:47-04:00).'
        - name: published_at_max
          in: query
          type: string
          description: 'Show custom collections published before date (format: 2014-04-25T16:15:47-04:00).'
        - name: published_status
          in: query
          type: string
          description: Show custom collectsion with a given published status.
        - name: fields
          in: query
          type: string
          description: Show only certain fields, specified by a comma-separated list of field names.
    - name: admin-api-2020-04-custom_collections-count.json
      path: /admin/api/2020-04/custom_collections/count.json
      operations:
      - name: deprecated202004getcustomcollectionscount
        method: GET
        description: Shopify Retrieves A Count Of Custom Collections
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: title
          in: query
          type: string
          description: Count custom collections with given title.
        - name: product_id
          in: query
          type: string
          description: Count custom collections that include a given product.
        - name: updated_at_min
          in: query
          type: string
          description: 'Count custom collections last updated after date (format: 2014-04-25T16:15:47-04:00).'
        - name: updated_at_max
          in: query
          type: string
          description: 'Count custom collections last updated before date (format: 2014-04-25T16:15:47-04:00).'
        - name: published_at_min
          in: query
          type: string
          description: 'Count custom collections published after date (format: 2014-04-25T16:15:47-04:00).'
        - name: published_at_max
          in: query
          type: string
          description: 'Count custom collections published before date (format: 2014-04-25T16:15:47-04:00).'
        - name: published_status
          in: query
          type: string
          description: Count custom collections with a given published status.
    - name: admin-api-2020-04-smart_collections.json
      path: /admin/api/2020-04/smart_collections.json
      operations:
      - name: deprecated202004getsmartcollections
        method: GET
        description: Shopify Retrieves A List Of Smart Collections
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: limit
          in: query
          type: string
          description: The number of results to show.
        - name: ids
          in: query
          type: string
          description: Show only the smart collections specified by a comma-separated list of IDs.
        - name: since_id
          in: query
          type: string
          description: Restrict results to after the specified ID.
        - name: title
          in: query
          type: string
          description: Show smart collections with the specified title.
        - name: product_id
          in: query
          type: string
          description: Show smart collections that includes the specified product.
        - name: handle
          in: query
          type: string
          description: Filter results by smart collection handle.
        - name: updated_at_min
          in: query
          type: string
          description: 'Show smart collections last updated after this date. (format: 2014-04-25T16:15:47-04:00)'
        - name: updated_at_max
          in: query
          type: string
          description: 'Show smart collections last updated before this date. (format: 2014-04-25T16:15:47-04:00)'
        - name: published_at_min
          in: query
          type: string
          description: 'Show smart collections published after this date. (format: 2014-04-25T16:15:47-04:00)'
        - name: published_at_max
          in: query
          type: string
          description: 'Show smart collections published before this date. (format: 2014-04-25T16:15:47-04:00)'
        - name: published_status
          in: query
          type: string
          description: Filter results based on the published status of smart collections.
        - name: fields
          in: query
          type: string
          description: Show only certain fields, specified by a comma-separated list of field names.
    - name: admin-api-2020-04-smart_collections-count.json
      path: /admin/api/2020-04/smart_collections/count.json
      operations:
      - name: deprecated202004getsmartcollectionscount
        method: GET
        description: Shopify Retrieves A Count Of Smart Collections
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: title
          in: query
          type: string
          description: Show smart collections with the specified title.
        - name: product_id
          in: query
          type: string
          description: Show smart collections that include the specified product.
        - name: updated_at_min
          in: query
          type: string
          description: 'Show smart collections last updated after this date. (format: 2014-04-25T16:15:47-04:00)'
        - name: updated_at_max
          in: query
          type: string
          description: 'Show smart collections last updated before this date.  (format: 2014-04-25T16:15:47-04:00)'
        - name: published_at_min
          in: query
          type: string
          description: 'Show smart collections published after this date.  (format: 2014-04-25T16:15:47-04:00)'
        - name: published_at_max
          in: query
          type: string
          description: 'Show smart collections published before this date.  (format: 2014-04-25T16:15:47-04:00)'
        - name: published_status
          in: query
          type: string
          description: Filter results based on the published status of smart collections.
    - name: admin-api-2020-07-custom_collections.json
      path: /admin/api/2020-07/custom_collections.json
      operations:
      - name: deprecated202007getcustomcollections
        method: GET
        description: Shopify Retrieves A List Of Custom Collections
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: limit
          in: query
          type: string
          description: The maximum number of results to retrieve.
        - name: ids
          in: query
          type: string
          description: Show only collections specified by a comma-separated list of IDs.
        - name: since_id
          in: query
          type: string
          description: Restrict results to after the specified ID.
        - name: title
          in: query
          type: string
          description: Show custom collections with a given title.
        - name: product_id
          in: query
          type: string
          description: Show custom collections that include a given product.
        - name: handle
          in: query
          type: string
          description: Filter by custom collection handle.
        - name: updated_at_min
          in: query
          type: string
          description: 'Show custom collections last updated after date (format: 2014-04-25T16:15:47-04:00).'
        - name: updated_at_max
          in: query
          type: string
          description: 'Show custom collections last updated before date (format: 2014-04-25T16:15:47-04:00).'
        - name: published_at_min
          in: query
          type: string
          description: 'Show custom collections published after date (format: 2014-04-25T16:15:47-04:00).'
        - name: published_at_max
          in: query
          type: string
          description: 'Show custom collections published before date (format: 2014-04-25T16:15:47-04:00).'
        - name: published_status
          in: query
          type: string
          description: Show custom collectsion with a given published status.
        - name: fields
          in: query
          type: string
          description: Show only certain fields, specified by a comma-separated list of field names.
    - name: admin-api-2020-07-custom_collections-count.json
      path: /admin/api/2020-07/custom_collections/count.json
      operations:
      - name: deprecated202007getcustomcollectionscount
        method: GET
        description: Shopify Retrieves A Count Of Custom Collections
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: title
          in: query
          type: string
          description: Count custom collections with given title.
        - name: product_id
          in: query
          type: string
          description: Count custom collections that include a given product.
        - name: updated_at_min
          in: query
          type: string
          description: 'Count custom collections last updated after date (format: 2014-04-25T16:15:47-04:00).'
        - name: updated_at_max
          in: query
          type: string
          description: 'Count custom collections last updated before date (format: 2014-04-25T16:15:47-04:00).'
        - name: published_at_min
          in: query
          type: string
          description: 'Count custom collections published after date (format: 2014-04-25T16:15:47-04:00).'
        - name: published_at_max
          in: query
          type: string
          description: 'Count custom collections published before date (format: 2014-04-25T16:15:47-04:00).'
        - name: published_status
          in: query
          type: string
          description: Count custom collections with a given published status.
    - name: admin-api-2020-07-smart_collections.json
      path: /admin/api/2020-07/smart_collections.json
      operations:
      - name: deprecated202007getsmartcollections
        method: GET
        description: Shopify Retrieves A List Of Smart Collections
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: limit
          in: query
          type: string
          description: The number of results to show.
        - name: ids
          in: query
          type: string
          description: Show only the smart collections specified by a comma-separated list of IDs.
        - name: since_id
          in: query
          type: string
          description: Restrict results to after the specified ID.
        - name: title
          in: query
          type: string
          description: Show smart collections with the specified title.
        - name: product_id
          in: query
          type: string
          description: Show smart collections that includes the specified product.
        - name: handle
          in: query
          type: string
          description: Filter results by smart collection handle.
        - name: updated_at_min
          in: query
          type: string
          description: 'Show smart collections last updated after this date. (format: 2014-04-25T16:15:47-04:00)'
        - name: updated_at_max
          in: query
          type: string
          description: 'Show smart collections last updated before this date. (format: 2014-04-25T16:15:47-04:00)'
        - name: published_at_min
          in: query
          type: string
          description: 'Show smart collections published after this date. (format: 2014-04-25T16:15:47-04:00)'
        - name: published_at_max
          in: query
          type: string
          description: 'Show smart collections published before this date. (format: 2014-04-25T16:15:47-04:00)'
        - name: published_status
          in: query
          type: string
          description: Filter results based on the published status of smart collections.
        - name: fields
          in: query
          type: string
          description: Show only certain fields, specified by a comma-separated list of field names.
    - name: admin-api-2020-07-smart_collections-count.json
      path: /admin/api/2020-07/smart_collections/count.json
      operations:
      - name: deprecated202007getsmartcollectionscount
        method: GET
        description: Shopify Retrieves A Count Of Smart Collections
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: title
          in: query
          type: string
          description: Show smart collections with the specified title.
        - name: product_id
          in: query
          type: string
          description: Show smart collections that include the specified product.
        - name: updated_at_min
          in: query
          type: string
          description: 'Show smart collections last updated after this date. (format: 2014-04-25T16:15:47-04:00)'
        - name: updated_at_max
          in: query
          type: string
          description: 'Show smart collections last updated before this date.  (format: 2014-04-25T16:15:47-04:00)'
        - name: published_at_min
          in: query
          type: string
          description: 'Show smart collections published after this date.  (format: 2014-04-25T16:15:47-04:00)'
        - name: published_at_max
          in: query
          type: string
          description: 'Show smart collections published before this date.  (format: 2014-04-25T16:15:47-04:00)'
        - name: published_status
          in: query
          type: string
          description: Filter results based on the published status of smart collections.
    - name: admin-api-2020-10-custom_collections.json
      path: /admin/api/2020-10/custom_collections.json
      operations:
      - name: getcustomcollections
        method: GET
        description: Shopify Retrieves A List Of Custom Collections
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: limit
          in: query
          type: string
          description: The maximum number of results to retrieve.
        - name: ids
          in: query
          type: string
          description: Show only collections specified by a comma-separated list of IDs.
        - name: since_id
          in: query
          type: string
          description: Restrict results to after the specified ID.
        - name: title
          in: query
          type: string
          description: Show custom collections with a given title.
        - name: product_id
          in: query
          type: string
          description: Show custom collections that include a given product.
        - name: handle
          in: query
          type: string
          description: Filter by custom collection handle.
        - name: updated_at_min
          in: query
          type: string
          description: 'Show custom collections last updated after date (format: 2014-04-25T16:15:47-04:00).'
        - name: updated_at_max
          in: query
          type: string
          description: 'Show custom collections last updated before date (format: 2014-04-25T16:15:47-04:00).'
        - name: published_at_min
          in: query
          type: string
          description: 'Show custom collections published after date (format: 2014-04-25T16:15:47-04:00).'
        - name: published_at_max
          in: query
          type: string
          description: 'Show custom collections published before date (format: 2014-04-25T16:15:47-04:00).'
        - name: published_status
          in: query
          type: string
          description: Show custom collectsion with a given published status.
        - name: fields
          in: query
          type: string
          description: Show only certain fields, specified by a comma-separated list of field names.
    - name: admin-api-2020-10-custom_collections-count.json
      path: /admin/api/2020-10/custom_collections/count.json
      operations:
      - name: getcustomcollectionscount
        method: GET
        description: Shopify Retrieves A Count Of Custom Collections
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: title
          in: query
          type: string
          description: Count custom collections with given title.
        - name: product_id
          in: query
          type: string
          description: Count custom collections that include a given product.
        - name: updated_at_min
          in: query
          type: string
          description: 'Count custom collections last updated after date (format: 2014-04-25T16:15:47-04:00).'
        - name: updated_at_max
          in: query
          type: string
          description: 'Count custom collections last updated before date (format: 2014-04-25T16:15:47-04:00).'
        - name: published_at_min
          in: query
          type: string
          description: 'Count custom collections published after date (format: 2014-04-25T16:15:47-04:00).'
        - name: published_at_max
          in: query
          type: string
          description: 'Count custom collections published before date (format: 2014-04-25T16:15:47-04:00).'
        - name: published_status
          in: query
          type: string
          description: Count custom collections with a given published status.
    - name: admin-api-2020-10-smart_collections.json
      path: /admin/api/2020-10/smart_collections.json
      operations:
      - name: getsmartcollections
        method: GET
        description: Shopify Retrieves A List Of Smart Collections
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: limit
          in: query
          type: string
          description: The number of results to show.
        - name: ids
          in: query
          type: string
          description: Show only the smart collections specified by a comma-separated list of IDs.
        - name: since_id
          in: query
          type: string
          description: Restrict results to after the specified ID.
        - name: title
          in: query
          type: string
          description: Show smart collections with the specified title.
        - name: product_id
          in: query
          type: string
          description: Show smart collections that includes the specified product.
        - name: handle
          in: query
          type: string
          description: Filter results by smart collection handle.
        - name: updated_at_min
          in: query
          type: string
          description: 'Show smart collections last updated after this date. (format: 2014-04-25T16:15:47-04:00)'
        - name: updated_at_max
          in: query
          type: string
          description: 'Show smart collections last updated before this date. (format: 2014-04-25T16:15:47-04:00)'
        - name: published_at_min
          in: query
          type: string
          description: 'Show smart collections published after this date. (format: 2014-04-25T16:15:47-04:00)'
        - name: published_at_max
          in: query
          type: string
          description: 'Show smart collections published before this date. (format: 2014-04-25T16:15:47-04:00)'
        - name: published_status
          in: query
          type: string
          description: Filter results based on the published status of smart collections.
        - name: fields
          in: query
          type: string
          description: Show only certain fields, specified by a comma-separated list of field names.
    - name: admin-api-2020-10-smart_collections-count.json
      path: /admin/api/2020-10/smart_collections/count.json
      operations:
      - name: getsmartcollectionscount
        method: GET
        description: Shopify Retrieves A Count Of Smart Collections
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: title
          in: query
          type: string
          description: Show smart collections with the specified title.
        - name: product_id
          in: query
          type: string
          description: Show smart collections that include the specified product.
        - name: updated_at_min
          in: query
          type: string
          description: 'Show smart collections last updated after this date. (format: 2014-04-25T16:15:47-04:00)'
        - name: updated_at_max
          in: query
          type: string
          description: 'Show smart collections last updated before this date.  (format: 2014-04-25T16:15:47-04:00)'
        - name: published_at_min
          in: query
          type: string
          description: 'Show smart collections published after this date.  (format: 2014-04-25T16:15:47-04:00)'
        - name: published_at_max
          in: query
          type: string
          description: 'Show smart collections published before this date.  (format: 2014-04-25T16:15:47-04:00)'
        - name: published_status
          in: query
          type: string
          description: Filter results based on the published status of smart collections.
    - name: admin-api-2021-01-custom_collections.json
      path: /admin/api/2021-01/custom_collections.json
      operations:
      - name: deprecated202101getcustomcollections
        method: GET
        description: Shopify Retrieves A List Of Custom Collections
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: limit
          in: query
          type: string
          description: The maximum number of results to retrieve.
        - name: ids
          in: query
          type: string
          description: Show only collections specified by a comma-separated list of IDs.
        - name: since_id
          in: 

# --- truncated at 32 KB (85 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/shopify/refs/heads/main/capabilities/shopify-collections.yaml