> ## Documentation Index
> Fetch the complete documentation index at: https://www.zinc.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# API Changelog

> Changes to the Zinc API across versions

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](/changelog).

***

## 2026-03-30

<Info>This is the current API version.</Info>

**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**

* `Address` — `state` 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.