Collection Count

🔒

Requires read_collection access scope. More access scope

The Get Collection Count API allows you to retrieve the total number of collections that match specific criteria. This endpoint supports filtering by collection IDs and update timestamps, enabling fine-grained control over the count retrieval.This API is especially useful for:

  1. Quickly determine the number of collections available in your store.
  2. Filter collections by update time or specific IDs to get a precise count.

Request Parameters

Public Request Parameters

📘

Public Request Parameters

Query Parameters

ParameterTypeRequiredExampleDescription
idsstringNoids=a60fe556-43ad-4e07-9125-507ac1bf71f7,b12f6556-43ad-4e07-9125-507ac1bf71e2Comma-separated list of collection IDs to filter by.
updated_at_minstringNoupdated_at_min=2024-01-01T00:00:00ZISO 8601 timestamp. Only include collections updated after this time.
updated_at_maxstringNoupdated_at_max=2024-12-31T23:59:59ZISO 8601 timestamp. Only include collections updated before this time.

Response Explanation

Public Response Parameters

📘

Public Response Parameters

Success Response

FieldTypeExampleDescription
countinteger15Total number of collections matching the filters.

Error Response

Error responses in the API can be represented using two different fields: errors and error. Both fields provide details about issues encountered during request processing. Below is an explanation of the fields with their respective examples and descriptions.

FieldTypeExampleDescription
errorsArray[ "UpdatedAtMin time format error"]A list of errors encountered during the request processing.
FieldTypeExampleDescription
errorArray "store is not active"Indicates an error encountered during the process.

Error Details

Status CodeMessagePossible ReasonExample Response
400Bad RequestInvalid input format or request structure (e.g., missing required fields or incorrect data types).Bad Request
UnauthorizedThe request is missing valid authentication credentials or the credentials provided are invalid.Unauthorized
422update_at_min time format errorThe update_at_min field is not in a valid time format.(e.g., not ISO8601).{"errors": ["update_at_min time format error"]}
update_at_max time format errorThe update_at_max field is not in a valid time format.(e.g., not ISO8601).{"errors": ["update_at_min time format error"]}
404store is not activeThe store name provided is not activate.{"errors": ["store is not active"]}
500no contextMissing Context{"errors": ["No context"]}

API Structure Overview

Language
Credentials
Header
URL
Click Try It! to start a request and see the response here!