Skip to main content
A version-by-version record of endpoints, fields, and schemas added or changed in the Zinc API. For product updates, new features, and general improvements, see the product changelog.

2026-03-30

This is the current API version.
New endpoints
  • POST /returns — Create Return Request
  • GET /returns — List Return Requests
  • GET /returns/{return_request_id} — Get Return Request
New schemas
  • ReturnRequestCreate, ReturnRequestResponse, ReturnRequestListResponse
  • ReturnRequestReason enum — return.request_label, nondelivery.not_delivered, nondelivery.damaged, nondelivery.empty_box, tracking.request_update, cancel.forced_cancellation, other
  • ReturnRequestStatus enum — open, in_progress, approved, denied, completed

2026-03-25

New endpoints
  • GET /products/search — Search Products
  • GET /products/{product_id} — Get Product
  • GET /products/{product_id}/offers — Get Product Offers
New schemas
  • ProductSearchResponse, ProductSearchResult
Changes
  • POST /agent/orders — Added 402 response code for MPP payment challenges

2026-03-23

New endpoints
  • POST /agent/orders — Create MPP Order
New schemas
  • LineItem
Changes
  • PriceComponents — Added line_items field (array of LineItem)
  • JobResultPayload — Added estimated_delivery field

2026-02-19

Changes
  • RetailerCredentialsCreate — Added retailer_config field
  • RetailerCredentialsUpdate — Added retailer_config field
  • RetailerCredentialsResponse — Added retailer_config and forwarding_email fields

2026-02-12

New endpoints
  • GET /managed-accounts — List Managed Accounts
  • POST /managed-accounts — Create Managed Account
  • PUT /managed-accounts/{short_id} — Update Managed Account
  • DELETE /managed-accounts/{short_id} — Delete Managed Account
  • GET /orders/{order_id}/events — Get Order Events
New schemas
  • OrderEventsResponse, ProgressEventResponse
  • RetailerCredentialsCreate, RetailerCredentialsListResponse, RetailerCredentialsResponse, RetailerCredentialsUpdate

2026-02-05

Changes
  • Addressstate field made optional and nullable to support international addresses

2026-01-28

Changes
  • OrderCreate — Added po_number field for purchase order tracking
  • OrderResponse — Added po_number field

2026-01-21

Changes
  • OrderCreate — Added metadata field for custom key-value data
  • OrderResponse — Added metadata field

2026-01-19

New endpoints
  • GET /orders/test-products — List Test Products
New schemas
  • TrackingNumberResponse
Changes
  • OrderResponse — Added attempts (integer) and tracking_numbers (array) fields

2026-01-09

Changes
  • GET /orders — Added order_id query parameter for filtering
  • OrderCreate — Added retailer_credentials_id field
  • OrderResponse — Added retailer_credentials_id field

2025-12-19

New endpoints
  • POST /orders/{order_id}/cancel — Cancel Order
New schemas
  • ProductVariant
Changes
  • OrderItemResponse — Added variant field
  • OrderProduct — Added variant field
  • OrderStatus enum — Added cancelled value
  • JobResultPayload — Several fields made optional/nullable

2025-11-24

Initial API version.