2026-07-10
This is the current API version.
TrackingNumberResponse— Addedestimated_delivery_date(carrier-reported delivery estimate as a destination-local calendar date;nulluntil the carrier reports one)POST /agent/orders— Added query parametermethod(restrict the402response to a single payment method, e.g.stripe,tempo, orx402, instead of advertising every configured method)POST /agent/orders— A present-but-invalid body (including malformed or non-object JSON) is now rejected with422before any payment challenge is issued or honored; only a bodyless discovery probe receives the lenient402GET /products/search—free_shippingno longer filters Amazon results (upstream search data under-reports Prime, so filtering would drop valid items); the filter now applies to Walmart only, and defaults tofalsefor all accounts (previouslytruefor BizAPI-enrolled accounts)GET /agent/products/search—free_shippingno longer filters Amazon results; Walmart only
2026-07-06
New endpointsGET /orders/{order_id}/timeline— Get Order TimelineGET /usage— Get My Usage
OrderMilestoneOrderTimelineResponseRecentCallUsageMetricUserUsageResponse
GET /orders/{order_id}/events— Get Order Events (now admin-only; use Get Order Timeline for order status)
OrderEventsResponse,ProgressEventResponse
ProductSearchResponse— Addednext_pagePublicRetailer— Addedno_account_needed,use_your_accountPublicRetailer— RemovedsupportedTrackingNumberResponse— Addedzinc_tracking_number,zinc_tracking_urlGET /agent/products/search— Added query parameterfree_shippingGET /products/search— Added query parameterfree_shipping
2026-06-26
New endpointsGET /agent/products/details— Agent Product DetailsGET /agent/products/offers— Agent Product OffersGET /agent/products/search— Agent Product SearchGET /agent/search— Agent SearchGET /retailers— List Retailers
ErrorDetailsFieldErrorPublicRetailerPublicRetailerListResponseTrackingCheckpointResponseTrackingStatusenum —pending,in_transit,delivered
OrderJobResult— Addederror_detailsTrackingNumberResponse— Addedcheckpoints,statusGET /orders— Added query parameterinclude
2026-06-19
New schemasMarginSpecOrderConnectInfoOrderJobResultOrderPaymentOrderPriceComponentsProductConditionenum —New,Refurbished,UsedLikeNew,UsedVeryGood,UsedGood,UsedAcceptable
JobResultPayloadLineItemMerchantOrderIdPriceComponents
OrderCreate— Addedhandling_days_max,is_gift,paymentOrderItemResponse— Addedcondition_in,condition_not_inOrderProduct— Addedcondition_in,condition_not_inOrderResponse— Addedconnect,handling_days_max,is_gift,job_result
2026-06-11
New endpointsGET /orders/bulk— List Bulk UploadsGET /orders/bulk/{batch_id}— Get Bulk UploadGET /orders/bulk/{batch_id}/results.csv— Download Bulk ResultsPOST /orders/bulk— Create Bulk UploadPOST /orders/bulk/validate— Validate Bulk Upload
BulkBatchListResponseBulkBatchResponseBulkBatchStatusenum —pending,processing,completed,failedBulkRowResultBulkRowValidationBulkUploadRequestBulkValidateResponse
OrderResponse— Addedretailer_credentials_uuidReturnRequestStatusenum — Addedcredited(return resolved by crediting the customer’s wallet)
2026-03-30
New endpointsPOST /returns— Create Return RequestGET /returns— List Return RequestsGET /returns/{return_request_id}— Get Return Request
ReturnRequestCreate,ReturnRequestResponse,ReturnRequestListResponseReturnRequestReasonenum —return.request_label,nondelivery.not_delivered,nondelivery.damaged,nondelivery.empty_box,tracking.request_update,cancel.forced_cancellation,otherReturnRequestStatusenum —open,in_progress,approved,denied,completed
2026-03-25
New endpointsGET /products/search— Search ProductsGET /products/{product_id}— Get ProductGET /products/{product_id}/offers— Get Product Offers
ProductSearchResponse,ProductSearchResult
POST /agent/orders— Added402response code for MPP payment challenges
2026-03-23
New endpointsPOST /agent/orders— Create MPP Order
LineItem
PriceComponents— Addedline_itemsfield (array ofLineItem)JobResultPayload— Addedestimated_deliveryfield
2026-02-19
ChangesRetailerCredentialsCreate— Addedretailer_configfieldRetailerCredentialsUpdate— Addedretailer_configfieldRetailerCredentialsResponse— Addedretailer_configandforwarding_emailfields
2026-02-12
New endpointsGET /managed-accounts— List Managed AccountsPOST /managed-accounts— Create Managed AccountPUT /managed-accounts/{short_id}— Update Managed AccountDELETE /managed-accounts/{short_id}— Delete Managed AccountGET /orders/{order_id}/events— Get Order Events
OrderEventsResponse,ProgressEventResponseRetailerCredentialsCreate,RetailerCredentialsListResponse,RetailerCredentialsResponse,RetailerCredentialsUpdate
2026-02-05
ChangesAddress—statefield made optional and nullable to support international addresses
2026-01-28
ChangesOrderCreate— Addedpo_numberfield for purchase order trackingOrderResponse— Addedpo_numberfield
2026-01-21
ChangesOrderCreate— Addedmetadatafield for custom key-value dataOrderResponse— Addedmetadatafield
2026-01-19
New endpointsGET /orders/test-products— List Test Products
TrackingNumberResponse
OrderResponse— Addedattempts(integer) andtracking_numbers(array) fields
2026-01-09
ChangesGET /orders— Addedorder_idquery parameter for filteringOrderCreate— Addedretailer_credentials_idfieldOrderResponse— Addedretailer_credentials_idfield
2025-12-19
New endpointsPOST /orders/{order_id}/cancel— Cancel Order
ProductVariant
OrderItemResponse— AddedvariantfieldOrderProduct— AddedvariantfieldOrderStatusenum — AddedcancelledvalueJobResultPayload— Several fields made optional/nullable