Fulfillment Total Count

🔒

Requires read_order access scope. More access scope

The Fulfillment Total Count API retrieves the total number of fulfillments for a specific order. This enables users to query the count of fulfillments created or updated within a given date range.

This API is especially useful for:

  1. Monitoring fulfillment activities for an order.
  2. Validating the number of fulfillments processed over time.
  3. Filtering fulfillments based on creation or update timestamps.

Request Parameters

Public Request Parameters

📘

Public Request Parameters

Path Parameters

ParameterTypeRequiredExampleDescription
order_idstringYes633130-00000012Unique identifier for the order.

Query Parameters

ParameterTypeRequiredExampleDescription
created_at_minstringNo2016-01-18T23:41:00ZFilter fulfillments created at or after this date (ISO-8601).
created_at_maxstringNo2016-01-18T23:41:00ZFilter fulfillments created at or before this date (ISO-8601).
updated_at_minstringNo2016-01-18T23:41:00ZFilter fulfillments updated at or after this date (ISO-8601).
updated_at_maxstringNo2016-01-18T23:41:00ZFilter fulfillments updated at or before this date (ISO-8601).

Response Explanation

Public Response Parameters

📘

Public Response Parameters

Successful Response

FieldTypeExampleDescription
countinteger1Total number of fulfillments.

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[ "Unable to find resource"]A list of errors encountered during the request processing.
FieldTypeExampleDescription
errorString "store is not active"Indicates an error encountered during the process

Error Detail

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
422created_at_max time format errorThe created_at_max field is not in a valid time format.(e.g., not ISO8601).{"errors": ["created_at_max time format error"]}
updated_at_min time format errorThe updated_at_min field is not in a valid time format.(e.g., not ISO8601).{"errors": ["updated_at_min time format error"]}
500System errorMissing order_id{"errors": ["System errort"]}
404provided order_id is not existingprovided order_id is not existing{"errors": ["Unable to find resource"]}

API Structure Overview

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