Own Shopify? Customize your docs with AI search, analytics, and more.

Claim your docs

GET

Retrieves a list of smart collections. Note: As of version 2019-10, this endpoint implements pagination by using links that are provided in the response header. To learn more, see Making requests to paginated REST Admin API endpoints.

https://shopify.com/admin/api/unstable/smart_collections.json

https://shopify.dev/docs/admin-api/rest/reference/products/smartcollection#index-unstable

Access Token Required: API Key

Query Params

limitstring

The number of results to show. (default: 50, maximum: 250)

idsstring

Show only the smart collections specified by a comma-separated list of IDs.

since_idstring

Restrict results to after the specified ID.

titlestring

Show smart collections with the specified title.

product_idstring

Show smart collections that includes the specified product.

handlestring

Filter results by smart collection handle.

updated_at_minstring

Show smart collections last updated after this date. (format: 2014-04-25T16:15:47-04:00)

updated_at_maxstring

Show smart collections last updated before this date. (format: 2014-04-25T16:15:47-04:00)

published_at_minstring

Show smart collections published after this date. (format: 2014-04-25T16:15:47-04:00)

published_at_maxstring

Show smart collections published before this date. (format: 2014-04-25T16:15:47-04:00)

published_statusstring

Filter results based on the published status of smart collections. (default: any) published: Show only published smart collections. unpublished: Show only unpublished smart collections. any: Show all smart collections.

fieldsstring

Show only certain fields, specified by a comma-separated list of field names.

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request GET \
2     --url 'https://shopify.com/admin/api/unstable/smart_collections.json' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}

GET

Retrieves a list of smart collections. Note: As of version 2019-10, this endpoint implements pagination by using links that are provided in the response header. To learn more, see Making requests to paginated REST Admin API endpoints.

https://shopify.com/admin/api/unstable/smart_collections.json

https://shopify.dev/docs/admin-api/rest/reference/products/smartcollection#index-unstable

Access Token Required: API Key

Query Params

limitstring

The number of results to show. (default: 50, maximum: 250)

idsstring

Show only the smart collections specified by a comma-separated list of IDs.

since_idstring

Restrict results to after the specified ID.

titlestring

Show smart collections with the specified title.

product_idstring

Show smart collections that includes the specified product.

handlestring

Filter results by smart collection handle.

updated_at_minstring

Show smart collections last updated after this date. (format: 2014-04-25T16:15:47-04:00)

updated_at_maxstring

Show smart collections last updated before this date. (format: 2014-04-25T16:15:47-04:00)

published_at_minstring

Show smart collections published after this date. (format: 2014-04-25T16:15:47-04:00)

published_at_maxstring

Show smart collections published before this date. (format: 2014-04-25T16:15:47-04:00)

published_statusstring

Filter results based on the published status of smart collections. (default: any) published: Show only published smart collections. unpublished: Show only unpublished smart collections. any: Show all smart collections.

fieldsstring

Show only certain fields, specified by a comma-separated list of field names.

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request GET \
2     --url 'https://shopify.com/admin/api/unstable/smart_collections.json' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}