Get Order Count

Provides the total number of orders matching the specified query parameters.

🔒

Requires read_order access scope. More access scope

The Get Order Count API retrieves detailed information about a specific order based on its unique ID.

This API is especially useful for:

  1. Viewing complete order information including line items and fulfillment status.
  2. Accessing customer and payment details associated with an order.
  3. Checking order financial and fulfillment status for processing.

Request Parameters

Public Request Parameters

📘

Query Parameters

ParameterTypeRequiredDescriptionExample
created_at_minstringNoStart of creation date range (ISO 8601)"2025-06-01T00:00:00Z"
created_at_maxstringNoEnd of creation date range (ISO 8601)"2025-06-30T23:59:59Z"
updated_at_minstringNoStart of update date range (ISO 8601)"2025-06-15T00:00:00Z"
updated_at_maxstringNoEnd of update date range (ISO 8601)"2025-06-15T23:59:59Z"
statusstringNoOrder lifecycle status"finished"
fulfillment_statusstringNoFilters orders by their financial status. Possible values: waiting (awaiting payment), paying (in progress), paid (completed), cancelled (canceled), failed (payment failed), refunding (refund in progress), refund_failed (refund failed), refunded (completed), partially_refunded (partial refund issued). paid"shipped"
financial_statusstringNoFilters orders by their fulfillment status. Possible values: initialled (initialized), waiting (awaiting fulfillment), partially_shipped (partially shipped), shipped (fully shipped), partially_finished (partially completed), finished (fully completed), cancelled (canceled), returning (in return process), returned (fully returned), partially_returned (partially returned)."paid"

Response Explanation

Public Response Parameters

📘

Successful Response

ParameterTypeExampleDescription
codestring"success"Status code of the API response
messagestring"Order retrieved successfully"Descriptive message about the response
data.countint32-Complete order object containing all details

Error Response

FieldTypeExampleDescription
codestringInvalidParameterError http message
messagestring``Error message
Language
Credentials
Header
URL
Click Try It! to start a request and see the response here!