$ curl -X POST api.packageretriever.com/v1/rates -H "Authorization: Bearer pr_live_..." -d '{"parcel":{"weight_oz":16}}'

Why we're free when everyone else charges

Why pay $99 a month for API access when you can get it for free?

๐ŸŽ‰

No subscription fees

Create an API key and start shipping. No credit card required to get started. No monthly minimums.

๐Ÿ™Œ

No per label markup

You pay the lowest carrier rate. We don't add a cent on top. Platform and BYOA labels both cost you exactly what the carrier would charge.

๐Ÿซก

Bring Your Own Account

Connect your UPS or FedEx account. Use your own negotiated rates at no surcharge. Or use our platform rates.

Everything you need to ship

One API, all carriers, every capability. Build a complete shipping integration in an afternoon.

๐Ÿ›’

Rate Shopping

Compare rates across USPS, UPS, and FedEx in a single request. Delivery estimates on every quote.

POST /v1/rates
๐Ÿช„

Label Creation

Buy a label from any quoted rate from all supported carriers. Get a tracking number, label PDF/PNG/ZPL, and delivery ETA instantly.

POST /v1/labels
๐Ÿ“

Real Time Tracking

Track shipments across any Package Retriever supported carriers. Get status updates, location events, and delivery confirmation.

POST /v1/trackers
โœ…

Address Validation

Validate and normalize addresses prior to generating label quotes. Detect residential vs. commercial for accurate surcharges.

POST /v1/addresses/validate
๐Ÿท๏ธ

Batch Labels

Create labels in bulk with a single batch request. Async processing with progress tracking and webhook notifications.

POST /v1/batches
๐Ÿช

Webhooks

HMAC signed webhook delivery for label.created events with automatic retries. Build event driven workflows tailored to your needs.

label.created

Built for developers

Simple integration. Powerful capabilities.

๐Ÿ”‘

Get your API key

Sign up, create a key from your dashboard, and start making requests. Test with sandbox keys first.

๐Ÿ“ฆ

Install the SDK

npm i @packageretriever/sdk or pip install packageretriever. TypeScript types included.

๐Ÿš€

Ship your first package

Fetch rates, pick the cheapest, buy a label. Three API calls from zero to tracking number.

Try it right now

This is a live sandbox. Click Run on each step and watch real API responses come back. No signup required.

Authorization:Bearer pr_test_demo_xxxxxxxxxxxxxxxx
Route:San Francisco, CAโ†’Austin, TXยท1 lb parcel
RequestPOST /v1/addresses/validate
{
  "name": "Demo Customer",
  "street1": "123 E 6th St",
  "city": "Austin",
  "state": "TX",
  "zip": "78701",
  "country": "US"
}
click Run to execute

The only shipping API that builds the integration for you

Don't want to spend time coding? Rookie can assess your codebase, create a new branch, and write the entire shipping integration, rate shopping, label creation, tracking, all of it. No other shipping API does the lifting for you like Rookie.

Recommended

Let Rookie build it

Point Rookie at your repo and it handles everything, analyzes your codebase, creates a branch, and writes production ready integration code tailored to your stack.

  • Assesses your codebase and identifies where shipping logic belongs
  • Creates a new branch with the complete integration built in
  • Walks you through verification to confirm everything works
  • Handles rate shopping, label creation, tracking, and error handling
OR

Build it yourself

Full REST API with everything you need to build a custom integration from scratch. Complete control over every request.

  • REST API with OpenAPI spec and interactive docs
  • TypeScript and Python SDKs
  • Sandbox mode with magic test values
  • HMAC signed webhooks with automatic retries

Connect any MCP compatible AI tool

The Unleashed MCP server lets Claude, Cursor, Windsurf, GitHub Copilot, and any other MCP compatible tool interact with the shipping API directly. No integration code needed.

Get your API key

Sign up for a free Package Retriever account and create an API key from your dashboard. No credit card required. Start in sandbox mode to test without spending a cent.

Your test key

pr_test_7kX9mP2vLqR4nW8j

Frequently asked questions

USPS, UPS, and FedEx. You can use our negotiated platform rates or connect your own carrier accounts (BYOA) at no surcharge.

Yes. Create a test API key (pr_test_...) and all requests return fixture data. No real labels are created, no charges are made. Magic test values trigger specific scenarios like validation failures and tracking states.

Yes, you need to create an account to generate an API key from your dashboard. The entire platform is free, including Unleashed.

Yes. Our API follows familiar patterns used by popular shipping APIs. Check our migration guide in the docs. Most integrations can be migrated in a day.