List Fulfillments
Fulfillments
List Fulfillments
Retrieve vendor-scoped fulfillment items with cursor-based pagination
GET
List Fulfillments
V2 Alpha — This endpoint is part of the V2 API preview. Breaking changes may occur.
Overview
Retrieve a paginated list of line items with their fulfillment status and tracking information, scoped to the authenticated vendor. Only line items belonging to the vendor are returned. Use this endpoint to monitor pending and completed fulfillments.Vendor Token Required — This endpoint requires a vendor-scoped JWT token. Merchant tokens will receive a 403 error.
Use Cases
- Fulfillment dashboard — Monitor pending and completed fulfillments for the vendor
- Shipping integration — Pull unfulfilled items for 3PL or warehouse systems
- Order management — Track the vendor’s fulfillment queue
Query Parameters
string
Filter by fulfillment status. One of:
fulfilled, unfulfilled.string
Filter by shipment status (max 50 characters).
string
Filter by date (minimum, ISO 8601). Example:
2024-01-01T00:00:00Z.string
Filter by date (maximum, ISO 8601).
string
Search in order name/number or line item name (max 200 characters).
integer
Number of items to return, forward pagination (1-100).
string
Cursor for forward pagination.
integer
Number of items to return, backward pagination (1-100).
string
Cursor for backward pagination.
Response
200