Skip to main content

Documentation Index

Fetch the complete documentation index at: https://packageretriever.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

​
Changelog

​
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