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

# Changelog

> API changes, new features, and deprecations.

# Changelog

## 2026-06-15

### Updates

* **Full addresses on labels.** `POST /v1/labels` now returns complete `from_address` and `to_address` objects with name, street, city, state, zip, country, phone, and email — not just ZIP codes. The full address and parcel data provided when fetching rates is now preserved through to the label response.
* **Shipment records on label purchase.** Every label purchased via the API now creates a corresponding shipment record internally. This means labels appear in the shipping history, support receipt printing, and can be cloned for repeat shipments.
* **Rate cache stores full context.** `POST /v1/rates` now retains the complete sender/recipient addresses and parcel dimensions alongside the rate data. This enables richer label responses and accurate shipment records without requiring the addresses to be re-submitted at purchase time.

## 2026-05-22

### New

* **OpenAPI specification.** A full OpenAPI 3.1 spec is now published at [`openapi.yaml`](https://docs.packageretriever.com/openapi.yaml). Generate clients, import into your API tool of choice, or browse the schemas directly.
* **Postman collection.** Import the [Package Retriever API collection](https://docs.packageretriever.com/postman/Package-Retriever-API.postman_collection.json) and the [sandbox environment](https://docs.packageretriever.com/postman/Package-Retriever-Sandbox.postman_environment.json) to start hitting the API in one click. Pre-wired requests cover address validation, rates, labels, tracking, and the wallet.
* **Interactive API demo.** A no-auth, in-browser demo runs the full validate → rates → label → track flow against [sandbox fixtures](/guides/sandbox-and-testing), so you can try the API before signing up.

### Updates

* **Address validation reliability.** The `POST /v1/addresses/validate` backend was migrated to Google's Places API (New), improving geocoding accuracy and timeout behavior. No request or response changes.
* **Rates engine consolidation.** `POST /v1/rates` now runs through a unified multi-carrier pipeline. Partial-result behavior is more predictable when a single carrier times out — successful carriers still return rates and `failed_carriers` lists the rest. See [rate limits](/guides/rate-limits) for retry guidance.

### Fixes

* Several documentation links in the API reference and quickstarts were corrected.
* Minor stability fixes across the rates, tracking, and webhook services.

## 2026-05-16

### NEW: Package Retriever API v1 Launch

The Package Retriever shipping API is now publicly available. Free multi-carrier label creation, rate shopping, tracking, and address validation — no subscription required.

**Endpoints:**

* `POST /v1/addresses/validate` — Address validation with residential classification
* `POST /v1/rates` — Multi-carrier rate shopping with carbon estimates
* `POST /v1/labels` — Label purchase with wallet deduction
* `GET /v1/labels/{id}` — Label details and void status
* `DELETE /v1/labels/{id}` — Label void request
* `POST /v1/trackers` — Tracking registration
* `GET /v1/trackers/{id}` — Tracking status and events
* `GET /v1/carrier-accounts` — List BYOA accounts
* `POST /v1/batches` — Batch creation (up to 5,000 labels)
* `POST /v1/batches/{id}/buy` — Start batch processing
* `GET /v1/batches/{id}` — Batch progress
* `GET /v1/wallet` — Wallet balance

**Carriers supported:** USPS, UPS, FedEx, Sendle

**Key features:**

* Prepaid wallet with auto-reload
* BYOA carrier accounts at no surcharge
* Sandbox mode (pr\_test\_ keys)
* label.created webhook with HMAC verification
* Published rate limits on all endpoints
* Normalized error codes with suggestions