Skip to main content

​
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. Generate clients, import into your API tool of choice, or browse the schemas directly.
  • Postman collection. Import the Package Retriever API collection and the sandbox environment 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, 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 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