get https://{shopdomain}.myshoplaza.com/openapi/2022-01/orders//fulfillments
Requires
read_orderaccess scope. More access scope
The Fulfillment List API retrieves a list of fulfillment records filtered by order ID, creation, and update time. This enables users to track the fulfillment status of products within an order.
This API is especially useful for:
- Fetching all fulfillments related to a specific order.
- Filtering fulfillments by creation or update timestamps.
- Tracking product-level fulfillment details, including shipping information.
Request Parameters
Public Request Parameters
Path Parameters
| Field | Type | Required | Example | Description |
|---|---|---|---|---|
order_id | string | Yes | 633130-00000012 | The unique identifier of the order. |
Query Parameters
| Field | Type | Example | Description |
|---|---|---|---|
limit | int32 | 250 | Maximum number of fulfillments returned per page (maximum: 250). |
page | int32 | 1 | The page number to return. |
created_at_min | string | 2016-01-18T23:41:00Z | Filter fulfillments created at or after this date. |
created_at_max | string | 2016-01-18T23:41:00Z | Filter fulfillments created at or before this date. |
updated_at_min | string | 2016-01-18T23:41:00Z | Filter fulfillments updated at or after this date. |
updated_at_max | string | 2016-01-18T23:41:00Z | Filter fulfillments updated at or before this date. |
Response Explanation
Public Response Parameters
Successful Response
| Field | Type | Example | Description |
|---|---|---|---|
fulfillments | array of objects | - | List of fulfillments. |
fulfillments[].id | string | 49a731b0-1b7e-47c3-94d9-6d688f36201e | Unique ID of the fulfillment. |
fulfillments[].order_id | string | 633130-00000012 | Associated order ID. |
fulfillments[].status | string | finished | Status of the fulfillment (finished, pending). |
fulfillments[].tracking_company | string | 燕文物流 | Name of the tracking company. |
fulfillments[].tracking_number | string | 11111111111 | Shipment tracking number. |
fulfillments[].tracking_company_code | string | DJ-11343 | Code of the tracking company. |
fulfillments[].tracking_url | string | https://tracking.example.com | URL for tracking the shipment. |
fulfillments[].created_at | string | 2024-04-22T06:58:01Z | Fulfillment creation time (ISO-8601). |
fulfillments[].updated_at | string | 2024-04-22T07:00:57Z | Fulfillment last update time (ISO-8601). |
fulfillments[].line_items | array of objects | - | List of line items included in this fulfillment. |
fulfillments[].line_items[].id | string | 7037bd0b-cb6b-453a-a936-b349d0c8bf5d | Unique ID of the line item. |
fulfillments[].line_items[].product_id | string | a1a88be0-a1d4-47e4-a2f2-ba6e131cf447 | ID of the product. |
fulfillments[].line_items[].variant_id | string | 88e68830-4ef5-4125-bf7d-aef8047176b2 | ID of the product variant. |
fulfillments[].line_items[].variant_title | string | S-blue-T | Title of the product variant. |
fulfillments[].line_items[].product_title | string | shirt | Title of the product. |
fulfillments[].line_items[].product_handle | string | shirt | Handle of the product. |
fulfillments[].line_items[].quantity | integer | 2 | Quantity of the product fulfilled. |
fulfillments[].line_items[].note | string | "" | Additional note for the line item. |
fulfillments[].line_items[].fulfillment_status | string | partially_returned | Fulfillment status for the line item. |
fulfillments[].line_items[].sku | string | T-M-S-blue-T-A001004 | SKU of the product. |
fulfillments[].line_items[].weight_unit | string | kg | Weight unit of the product. |
fulfillments[].line_items[].vendor | string | shoplazza | Vendor of the product. |
fulfillments[].line_items[].product_url | string | /products/shirt | URL of the product. |
fulfillments[].line_items[].compare_at_price | string | 97.00 | Original compare-at price of the product. |
fulfillments[].line_items[].image | string | //cdn.shoplazza.com/image.jpeg | Image URL of the product. |
fulfillments[].line_items[].price | string | 81.00 | Price per unit of the product. |
fulfillments[].line_items[].total | string | 162.00 | Total price for the fulfilled quantity. |
fulfillments[].line_items[].weight | string | 1.10 | Weight of the product. |
fulfillments[].line_items[].properties | array of objects | - | Custom properties of the product. |
fulfillments[].line_items[].properties[].name | string | size | Name of the custom property. |
fulfillments[].line_items[].properties[].value | string | S | Value of the custom property. |
fulfillments[].line_items[].custom_properties | object | {} | Custom properties provided as key-value pairs. |
fulfillments[].line_items[].refund_quantity | integer | 0 | Quantity refunded for this line item. |
fulfillments[].line_items[].refund_total | string | 81.00 | Total refund amount for the line item. |
fulfillments[].line_items[].taxable | boolean | true | Indicates if the product is taxable. |
fulfillments[].line_items[].requires_shipping | boolean | true | Indicates if shipping is required. |
fulfillments[].line_items[].shipping_quantity | integer | 2 | Quantity shipped for this line item. |
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.
| Field | Type | Example | Description |
|---|---|---|---|
errors | Array | [ "invalid line_item id"] | A list of errors encountered during the request processing. |
| Field | Type | Example | Description |
|---|---|---|---|
error | String | "store is not active" | Indicates an error encountered during the process |
Error Detail
| Status Code | Message | Possible Reason | Example Response |
|---|---|---|---|
| 400 | Bad Request | Invalid input format or request structure (e.g., missing required fields or incorrect data types). | Bad Request |
| Unauthorized | The request is missing valid authentication credentials or the credentials provided are invalid. | Unauthorized | |
| 422 | update_at_min time format error | The 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 error | The update_at_max field is not in a valid time format.(e.g., not ISO8601). | {"errors": ["update_at_min time format error"]} | |
| 500 | no context | Missing Context | {"errors": ["No context"]} |
| 404 | provided order_id is not existing | provided order_id is not existing | {"errors": ["Record not found"]} |