$ 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 carrier rate. We don't add a cent on top. Platform labels and BYOA labels both cost you what the carrier charges.

๐Ÿ”“

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. Get a tracking number, label PDF/PNG/ZPL, and delivery ETA instantly.

POST /v1/labels
๐Ÿ“

Real Time Tracking

Track any shipment across any carrier. Get status updates, location events, and delivery confirmation.

POST /v1/trackers
โœ…

Address Validation

Validate and normalize addresses before shipping. 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.

label.created

How we compare

Every competitor charges for what we give away.

UnleashedShipStationShippo
API AccessFree$99/mo$10/mo+
Per Label Fee$0Included$0.05+
BYOA Surcharge$0N/A$0.05
Multi Carrierโœ…โœ…โœ…
Sandbox Modeโœ…โœ…โœ…
Batch Labelsโœ…โœ…โœ…

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 label

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.

ship-a-package.sh
sandbox
Authorization:Bearer pr_test_demo_xxxxxxxxxxxxxxxx
Route:San Francisco, CAโ†’Austin, TXยท1 lb parcel
1Validate Address
RequestPOST /v1/addresses/validate
{
  "name": "Demo Customer",
  "street1": "123 E 6th St",
  "city": "Austin",
  "state": "TX",
  "zip": "78701",
  "country": "US"
}
2Get Rates
3Buy Label
4Track Shipment

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
  • Walks you through verification to confirm everything works
  • Handles rate shopping, label creation, tracking, and error handling
๐Ÿ‘จโ€๐Ÿ’ป

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.

1

Get your API key

Sign up for a free Package Retriever account and create an API key from your dashboard. Use a pr_test_ key to start in sandbox mode.

2

Add the MCP server to your tool

Add the following to your MCP configuration. The location depends on your tool:

Claude Code / Cursor / Windsurf

{
  "mcpServers": {
    "packageretriever": {
      "url": "https://packageretriever.com/api/unleashed/mcp",
      "headers": {
        "Authorization": "Bearer pr_test_your_api_key"
      }
    }
  }
}

GitHub Copilot (VS Code settings.json)

"github.copilot.chat.mcpServers": {
  "packageretriever": {
    "url": "https://packageretriever.com/api/unleashed/mcp",
    "headers": {
      "Authorization": "Bearer pr_test_your_api_key"
    }
  }
}
3

Start shipping

Type naturally. Your AI tool now has access to 8 shipping tools:

validate_addressget_shipping_ratesbuy_shipping_labeltrack_shipmentget_labelvoid_labelget_wallet_balancelist_carrier_accounts
4

Go live

When you are ready for production, swap your pr_test_ key for a pr_live_ key. Same config, same tools, real labels.

Frequently asked questions

What carriers are supported?
USPS, UPS, and FedEx. You can use our negotiated platform rates or connect your own carrier accounts (BYOA) at no surcharge.
Is there a sandbox for testing?
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.
Do I need a Package Retriever account?
Yes, you need to create an account to generate an API key from your dashboard. The entire platform is free, including Unleashed.
Can I migrate from another shipping API?
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.