How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Shopify Collection API

The Collection API from Shopify — 66 operation(s) for collection.

Shopify Collection API is one of 213 APIs that Shopify publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 8 JSON Schema definitions.

Tagged areas include Collection. The published artifact set on APIs.io includes an OpenAPI specification, a JSON-LD context, API documentation, an API reference, and 8 JSON Schemas.

This API exposes 102 operations across 66 paths. It is described by OpenAPI 3.2.0, at version 2025-01.

Requests are made against a single base URL, https://{store}.myshopify.com/admin/api/2025-01.

102 operations 66 paths 0 schemas 24 DELETE36 GET18 POST24 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
2025-01
Server
https://{store}.myshopify.com/admin/api/2025-01
Authentication
API Key
Contact
Resource Areas
1

Authentication & Security 1

Shopify Collection API declares 1 security scheme for authenticating requests. An API key is passed in the header as X-Shopify-Access-Token (AccessToken). By default, every request must be authenticated.

  • AccessToken — Access token obtained via OAuth

Paths & Operations 102

Across 66 paths, the API surfaces 102 operations — 24 DELETE, 36 GET, 18 POST, 24 PUT. Each is listed below with its method, path, parameters, and response codes.

Collection 102
POST
/admin/api/2020-01/collects.json
Shopify Adds A Product To A Custom Collection
deprecated_202001_create_collects body → 200
DELETE
/admin/api/2020-01/collects/{collect_id}.json
Shopify Removes A Product From A Collection
deprecated_202001_delete_collects_param_collect_id 1 param → 200
POST
/admin/api/2020-04/collects.json
Shopify Adds A Product To A Custom Collection
deprecated_202004_create_collects body → 200
DELETE
/admin/api/2020-04/collects/{collect_id}.json
Shopify Removes A Product From A Collection
deprecated_202004_delete_collects_param_collect_id 1 param → 200
POST
/admin/api/2020-07/collects.json
Shopify Adds A Product To A Custom Collection
deprecated_202007_create_collects body → 200
DELETE
/admin/api/2020-07/collects/{collect_id}.json
Shopify Removes A Product From A Collection
deprecated_202007_delete_collects_param_collect_id 1 param → 200
POST
/admin/api/2020-10/collects.json
Shopify Adds A Product To A Custom Collection
create_collects body → 200
DELETE
/admin/api/2020-10/collects/{collect_id}.json
Shopify Removes A Product From A Collection
delete_collects_param_collect_id 1 param → 200
POST
/admin/api/2021-01/collects.json
Shopify Adds A Product To A Custom Collection
deprecated_202101_create_collects body → 200
DELETE
/admin/api/2021-01/collects/{collect_id}.json
Shopify Removes A Product From A Collection
deprecated_202101_delete_collects_param_collect_id 1 param → 200
POST
/admin/api/unstable/collects.json
Shopify Adds A Product To A Custom Collection
deprecated_unstable_create_collects body → 200
DELETE
/admin/api/unstable/collects/{collect_id}.json
Shopify Removes A Product From A Collection
deprecated_unstable_delete_collects_param_collect_id 1 param → 200
GET
/admin/api/2020-01/collections/{collection_id}.json
Shopify Retrieves A Single Collection
deprecated_202001_get_collections_param_collection_id 2 params → 200
GET
/admin/api/2020-01/collections/{collection_id}/products.json
Shopify Retrieve A List Of Products Belonging To A Collection
deprecated_202001_get_collections_param_collection_id_products 2 params → 200
GET
/admin/api/2020-04/collections/{collection_id}.json
Shopify Retrieves A Single Collection
deprecated_202004_get_collections_param_collection_id 2 params → 200
GET
/admin/api/2020-04/collections/{collection_id}/products.json
Shopify Retrieve A List Of Products Belonging To A Collection
deprecated_202004_get_collections_param_collection_id_products 2 params → 200
GET
/admin/api/2020-07/collections/{collection_id}.json
Shopify Retrieves A Single Collection
deprecated_202007_get_collections_param_collection_id 2 params → 200
GET
/admin/api/2020-07/collections/{collection_id}/products.json
Shopify Retrieve A List Of Products Belonging To A Collection
deprecated_202007_get_collections_param_collection_id_products 2 params → 200
GET
/admin/api/2020-10/collections/{collection_id}.json
Shopify Retrieves A Single Collection
get_collections_param_collection_id 2 params → 200
GET
/admin/api/2020-10/collections/{collection_id}/products.json
Shopify Retrieve A List Of Products Belonging To A Collection
get_collections_param_collection_id_products 2 params → 200
GET
/admin/api/2021-01/collections/{collection_id}.json
Shopify Retrieves A Single Collection
deprecated_202101_get_collections_param_collection_id 2 params → 200
GET
/admin/api/2021-01/collections/{collection_id}/products.json
Shopify Retrieve A List Of Products Belonging To A Collection
deprecated_202101_get_collections_param_collection_id_products 2 params → 200
GET
/admin/api/unstable/collections/{collection_id}.json
Shopify Retrieves A Single Collection
deprecated_unstable_get_collections_param_collection_id 2 params → 200
GET
/admin/api/unstable/collections/{collection_id}/products.json
Shopify Retrieve A List Of Products Belonging To A Collection
deprecated_unstable_get_collections_param_collection_id_products 2 params → 200
POST
/admin/api/2020-01/custom_collections.json
Shopify Creates A Custom Collection
deprecated_202001_create_custom_collections body → 200
GET
/admin/api/2020-01/custom_collections/{custom_collection_id}.json
Shopify Retrieves A Single Custom Collection
deprecated_202001_get_custom_collections_param_custom_collection_id 2 params → 200
PUT
/admin/api/2020-01/custom_collections/{custom_collection_id}.json
Shopify Updates An Existing Custom Collection
deprecated_202001_update_custom_collections_param_custom_collection_id 1 param body → 200
DELETE
/admin/api/2020-01/custom_collections/{custom_collection_id}.json
Shopify Deletes A Custom Collection
deprecated_202001_delete_custom_collections_param_custom_collection_id 1 param → 200
POST
/admin/api/2020-04/custom_collections.json
Shopify Creates A Custom Collection
deprecated_202004_create_custom_collections body → 200
GET
/admin/api/2020-04/custom_collections/{custom_collection_id}.json
Shopify Retrieves A Single Custom Collection
deprecated_202004_get_custom_collections_param_custom_collection_id 2 params → 200
PUT
/admin/api/2020-04/custom_collections/{custom_collection_id}.json
Shopify Updates An Existing Custom Collection
deprecated_202004_update_custom_collections_param_custom_collection_id 1 param body → 200
DELETE
/admin/api/2020-04/custom_collections/{custom_collection_id}.json
Shopify Deletes A Custom Collection
deprecated_202004_delete_custom_collections_param_custom_collection_id 1 param → 200
POST
/admin/api/2020-07/custom_collections.json
Shopify Creates A Custom Collection
deprecated_202007_create_custom_collections body → 200
GET
/admin/api/2020-07/custom_collections/{custom_collection_id}.json
Shopify Retrieves A Single Custom Collection
deprecated_202007_get_custom_collections_param_custom_collection_id 2 params → 200
PUT
/admin/api/2020-07/custom_collections/{custom_collection_id}.json
Shopify Updates An Existing Custom Collection
deprecated_202007_update_custom_collections_param_custom_collection_id 1 param body → 200
DELETE
/admin/api/2020-07/custom_collections/{custom_collection_id}.json
Shopify Deletes A Custom Collection
deprecated_202007_delete_custom_collections_param_custom_collection_id 1 param → 200
POST
/admin/api/2020-10/custom_collections.json
Shopify Creates A Custom Collection
create_custom_collections body → 200
GET
/admin/api/2020-10/custom_collections/{custom_collection_id}.json
Shopify Retrieves A Single Custom Collection
get_custom_collections_param_custom_collection_id 2 params → 200
PUT
/admin/api/2020-10/custom_collections/{custom_collection_id}.json
Shopify Updates An Existing Custom Collection
update_custom_collections_param_custom_collection_id 1 param body → 200
DELETE
/admin/api/2020-10/custom_collections/{custom_collection_id}.json
Shopify Deletes A Custom Collection
delete_custom_collections_param_custom_collection_id 1 param → 200
POST
/admin/api/2021-01/custom_collections.json
Shopify Creates A Custom Collection
deprecated_202101_create_custom_collections body → 200
GET
/admin/api/2021-01/custom_collections/{custom_collection_id}.json
Shopify Retrieves A Single Custom Collection
deprecated_202101_get_custom_collections_param_custom_collection_id 2 params → 200
PUT
/admin/api/2021-01/custom_collections/{custom_collection_id}.json
Shopify Updates An Existing Custom Collection
deprecated_202101_update_custom_collections_param_custom_collection_id 1 param body → 200
DELETE
/admin/api/2021-01/custom_collections/{custom_collection_id}.json
Shopify Deletes A Custom Collection
deprecated_202101_delete_custom_collections_param_custom_collection_id 1 param → 200
POST
/admin/api/unstable/custom_collections.json
Shopify Creates A Custom Collection
deprecated_unstable_create_custom_collections body → 200
GET
/admin/api/unstable/custom_collections/{custom_collection_id}.json
Shopify Retrieves A Single Custom Collection
deprecated_unstable_get_custom_collections_param_custom_collection_id 2 params → 200
PUT
/admin/api/unstable/custom_collections/{custom_collection_id}.json
Shopify Updates An Existing Custom Collection
deprecated_unstable_update_custom_collections_param_custom_collection_id 1 param body → 200
DELETE
/admin/api/unstable/custom_collections/{custom_collection_id}.json
Shopify Deletes A Custom Collection
deprecated_unstable_delete_custom_collections_param_custom_collection_id 1 param → 200
POST
/admin/api/2020-01/smart_collections.json
Shopify Creates A New Smart Collection Using The Specified Rules
deprecated_202001_create_smart_collections body → 200
GET
/admin/api/2020-01/smart_collections/{smart_collection_id}.json
Shopify Retrieves A Single Smart Collection
deprecated_202001_get_smart_collections_param_smart_collection_id 2 params → 200
PUT
/admin/api/2020-01/smart_collections/{smart_collection_id}.json
Shopify Updates An Existing Smart Collection
deprecated_202001_update_smart_collections_param_smart_collection_id 1 param body → 200
DELETE
/admin/api/2020-01/smart_collections/{smart_collection_id}.json
Shopify Removes A Smart Collection
deprecated_202001_delete_smart_collections_param_smart_collection_id 1 param → 200
PUT
/admin/api/2020-01/smart_collections/{smart_collection_id}/order.json
Shopify Updates The Ordering Type Of Products In A Smart Collection
deprecated_202001_update_smart_collections_param_smart_collection_id_order 4 params body → 200
POST
/admin/api/2020-04/smart_collections.json
Shopify Creates A New Smart Collection Using The Specified Rules
deprecated_202004_create_smart_collections body → 200
GET
/admin/api/2020-04/smart_collections/{smart_collection_id}.json
Shopify Retrieves A Single Smart Collection
deprecated_202004_get_smart_collections_param_smart_collection_id 2 params → 200
PUT
/admin/api/2020-04/smart_collections/{smart_collection_id}.json
Shopify Updates An Existing Smart Collection
deprecated_202004_update_smart_collections_param_smart_collection_id 1 param body → 200
DELETE
/admin/api/2020-04/smart_collections/{smart_collection_id}.json
Shopify Removes A Smart Collection
deprecated_202004_delete_smart_collections_param_smart_collection_id 1 param → 200
PUT
/admin/api/2020-04/smart_collections/{smart_collection_id}/order.json
Shopify Updates The Ordering Type Of Products In A Smart Collection
deprecated_202004_update_smart_collections_param_smart_collection_id_order 4 params body → 200
POST
/admin/api/2020-07/smart_collections.json
Shopify Creates A New Smart Collection Using The Specified Rules
deprecated_202007_create_smart_collections body → 200
GET
/admin/api/2020-07/smart_collections/{smart_collection_id}.json
Shopify Retrieves A Single Smart Collection
deprecated_202007_get_smart_collections_param_smart_collection_id 2 params → 200
PUT
/admin/api/2020-07/smart_collections/{smart_collection_id}.json
Shopify Updates An Existing Smart Collection
deprecated_202007_update_smart_collections_param_smart_collection_id 1 param body → 200
DELETE
/admin/api/2020-07/smart_collections/{smart_collection_id}.json
Shopify Removes A Smart Collection
deprecated_202007_delete_smart_collections_param_smart_collection_id 1 param → 200
PUT
/admin/api/2020-07/smart_collections/{smart_collection_id}/order.json
Shopify Updates The Ordering Type Of Products In A Smart Collection
deprecated_202007_update_smart_collections_param_smart_collection_id_order 4 params body → 200
POST
/admin/api/2020-10/smart_collections.json
Shopify Creates A New Smart Collection Using The Specified Rules
create_smart_collections body → 200
GET
/admin/api/2020-10/smart_collections/{smart_collection_id}.json
Shopify Retrieves A Single Smart Collection
get_smart_collections_param_smart_collection_id 2 params → 200
PUT
/admin/api/2020-10/smart_collections/{smart_collection_id}.json
Shopify Updates An Existing Smart Collection
update_smart_collections_param_smart_collection_id 1 param body → 200
DELETE
/admin/api/2020-10/smart_collections/{smart_collection_id}.json
Shopify Removes A Smart Collection
delete_smart_collections_param_smart_collection_id 1 param → 200
PUT
/admin/api/2020-10/smart_collections/{smart_collection_id}/order.json
Shopify Updates The Ordering Type Of Products In A Smart Collection
update_smart_collections_param_smart_collection_id_order 4 params body → 200
POST
/admin/api/2021-01/smart_collections.json
Shopify Creates A New Smart Collection Using The Specified Rules
deprecated_202101_create_smart_collections body → 200
GET
/admin/api/2021-01/smart_collections/{smart_collection_id}.json
Shopify Retrieves A Single Smart Collection
deprecated_202101_get_smart_collections_param_smart_collection_id 2 params → 200
PUT
/admin/api/2021-01/smart_collections/{smart_collection_id}.json
Shopify Updates An Existing Smart Collection
deprecated_202101_update_smart_collections_param_smart_collection_id 1 param body → 200
DELETE
/admin/api/2021-01/smart_collections/{smart_collection_id}.json
Shopify Removes A Smart Collection
deprecated_202101_delete_smart_collections_param_smart_collection_id 1 param → 200
PUT
/admin/api/2021-01/smart_collections/{smart_collection_id}/order.json
Shopify Updates The Ordering Type Of Products In A Smart Collection
deprecated_202101_update_smart_collections_param_smart_collection_id_order 4 params body → 200
POST
/admin/api/unstable/smart_collections.json
Shopify Creates A New Smart Collection Using The Specified Rules
deprecated_unstable_create_smart_collections body → 200
GET
/admin/api/unstable/smart_collections/{smart_collection_id}.json
Shopify Retrieves A Single Smart Collection
deprecated_unstable_get_smart_collections_param_smart_collection_id 2 params → 200
PUT
/admin/api/unstable/smart_collections/{smart_collection_id}.json
Shopify Updates An Existing Smart Collection
deprecated_unstable_update_smart_collections_param_smart_collection_id 1 param body → 200
DELETE
/admin/api/unstable/smart_collections/{smart_collection_id}.json
Shopify Removes A Smart Collection
deprecated_unstable_delete_smart_collections_param_smart_collection_id 1 param → 200
PUT
/admin/api/unstable/smart_collections/{smart_collection_id}/order.json
Shopify Updates The Ordering Type Of Products In A Smart Collection
deprecated_unstable_update_smart_collections_param_smart_collection_id_order 4 params body → 200
GET
/admin/api/2020-01/collection_listings.json
Shopify Retrieve Collection Listings That Are Published To Your App
deprecated_202001_get_collection_listings 1 param → 200
GET
/admin/api/2020-01/collection_listings/{collection_listing_id}.json
Shopify Retrieve A Specific Collection Listing That Is Published To Your App
deprecated_202001_get_collection_listings_param_collection_listing_id 1 param → 200
PUT
/admin/api/2020-01/collection_listings/{collection_listing_id}.json
Shopify Create A Collection Listing To Publish A Collection To Your App
deprecated_202001_update_collection_listings_param_collection_listing_id 1 param body → 200
DELETE
/admin/api/2020-01/collection_listings/{collection_listing_id}.json
Shopify Delete A Collection Listing To Unpublish A Collection From Your App
deprecated_202001_delete_collection_listings_param_collection_listing_id 1 param → 200
GET
/admin/api/2020-04/collection_listings.json
Shopify Retrieve Collection Listings That Are Published To Your App
deprecated_202004_get_collection_listings 1 param → 200
GET
/admin/api/2020-04/collection_listings/{collection_listing_id}.json
Shopify Retrieve A Specific Collection Listing That Is Published To Your App
deprecated_202004_get_collection_listings_param_collection_listing_id 1 param → 200
PUT
/admin/api/2020-04/collection_listings/{collection_listing_id}.json
Shopify Create A Collection Listing To Publish A Collection To Your App
deprecated_202004_update_collection_listings_param_collection_listing_id 1 param body → 200
DELETE
/admin/api/2020-04/collection_listings/{collection_listing_id}.json
Shopify Delete A Collection Listing To Unpublish A Collection From Your App
deprecated_202004_delete_collection_listings_param_collection_listing_id 1 param → 200
GET
/admin/api/2020-07/collection_listings.json
Shopify Retrieve Collection Listings That Are Published To Your App
deprecated_202007_get_collection_listings 1 param → 200
GET
/admin/api/2020-07/collection_listings/{collection_listing_id}.json
Shopify Retrieve A Specific Collection Listing That Is Published To Your App
deprecated_202007_get_collection_listings_param_collection_listing_id 1 param → 200
PUT
/admin/api/2020-07/collection_listings/{collection_listing_id}.json
Shopify Create A Collection Listing To Publish A Collection To Your App
deprecated_202007_update_collection_listings_param_collection_listing_id 1 param body → 200
DELETE
/admin/api/2020-07/collection_listings/{collection_listing_id}.json
Shopify Delete A Collection Listing To Unpublish A Collection From Your App
deprecated_202007_delete_collection_listings_param_collection_listing_id 1 param → 200
GET
/admin/api/2020-10/collection_listings.json
Shopify Retrieve Collection Listings That Are Published To Your App
get_collection_listings 1 param → 200
GET
/admin/api/2020-10/collection_listings/{collection_listing_id}.json
Shopify Retrieve A Specific Collection Listing That Is Published To Your App
get_collection_listings_param_collection_listing_id 1 param → 200
PUT
/admin/api/2020-10/collection_listings/{collection_listing_id}.json
Shopify Create A Collection Listing To Publish A Collection To Your App
update_collection_listings_param_collection_listing_id 1 param body → 200
DELETE
/admin/api/2020-10/collection_listings/{collection_listing_id}.json
Shopify Delete A Collection Listing To Unpublish A Collection From Your App
delete_collection_listings_param_collection_listing_id 1 param → 200
GET
/admin/api/2021-01/collection_listings.json
Shopify Retrieve Collection Listings That Are Published To Your App
deprecated_202101_get_collection_listings 1 param → 200
GET
/admin/api/2021-01/collection_listings/{collection_listing_id}.json
Shopify Retrieve A Specific Collection Listing That Is Published To Your App
deprecated_202101_get_collection_listings_param_collection_listing_id 1 param → 200
PUT
/admin/api/2021-01/collection_listings/{collection_listing_id}.json
Shopify Create A Collection Listing To Publish A Collection To Your App
deprecated_202101_update_collection_listings_param_collection_listing_id 1 param body → 200
DELETE
/admin/api/2021-01/collection_listings/{collection_listing_id}.json
Shopify Delete A Collection Listing To Unpublish A Collection From Your App
deprecated_202101_delete_collection_listings_param_collection_listing_id 1 param → 200
GET
/admin/api/unstable/collection_listings.json
Shopify Retrieve Collection Listings That Are Published To Your App
deprecated_unstable_get_collection_listings 1 param → 200
GET
/admin/api/unstable/collection_listings/{collection_listing_id}.json
Shopify Retrieve A Specific Collection Listing That Is Published To Your App
deprecated_unstable_get_collection_listings_param_collection_listing_id 1 param → 200
PUT
/admin/api/unstable/collection_listings/{collection_listing_id}.json
Shopify Create A Collection Listing To Publish A Collection To Your App
deprecated_unstable_update_collection_listings_param_collection_listing_id 1 param body → 200
DELETE
/admin/api/unstable/collection_listings/{collection_listing_id}.json
Shopify Delete A Collection Listing To Unpublish A Collection From Your App
deprecated_unstable_delete_collection_listings_param_collection_listing_id 1 param → 200

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

shopify-collection-api-openapi.yml Raw ↑

Other APIs Shopify publishes across the network.

Shopify GraphQL Admin API
Shopify Storefront API
Shopify Customer Account API
Shopify Partner API
Shopify Payments Apps API
Shopify Liquid API
Shopify Functions API
Shopify Discount Function API
Shopify Webhooks API
Shopify App Bridge
Shopify App Home API
Shopify Checkout UI Extensions API
Where this information came from

This is an independent, third-party profile of Shopify Collection API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.