npm install @packageretriever/sdk

import PackageRetriever from '@packageretriever/sdk';

const pr = new PackageRetriever('pr_test_YOUR_KEY_HERE');

const validated = await pr.addresses.validate({
  name: 'Jane Smith',
  street1: '417 Montgomery St',
  city: 'San Francisco',
  state: 'CA',
  zip: '94104',
  country: 'US'
});

console.log(validated.valid);                      // true
console.log(validated.delivery_type);              // 'commercial'
console.log(validated.residential_surcharge_applies); // false

const rates = await pr.rates.get({
  from_address: {
    name: 'Warehouse',
    street1: '417 Montgomery St',
    city: 'San Francisco',
    state: 'CA',
    zip: '94105',
    country: 'US'
  },
  to_address: {
    name: 'Customer',
    street1: '123 Main St',
    city: 'Austin',
    state: 'TX',
    zip: '78701',
    country: 'US'
  },
  parcel: {
    weight_oz: 16,
    length: 9,
    width: 6,
    height: 2
  }
});

// Sorted cheapest first
console.log(rates.rates[0]);
// {
//   carrier: 'USPS',
//   service: 'Ground Advantage',
//   rate_cents: 542,
//   carrier_eta: '2026-05-20',
//   carbon_grams: 142
// }

const label = await pr.labels.create({
  rate_id: rates.rates[0].id
});

console.log(label.tracking_number); // 9999... (sandbox)
console.log(label.label_url);       // Sample PDF URL
console.log(label.rate_cents);      // 542

import PackageRetriever from '@packageretriever/sdk';

const pr = new PackageRetriever(process.env.PR_API_KEY!);

async function shipOrder(order: { address: any; weight_oz: number }) {
  // 1. Get rates
  const rates = await pr.rates.get({
    from_address: { name: 'My Store', street1: '417 Montgomery St', city: 'San Francisco', state: 'CA', zip: '94105', country: 'US' },
    to_address: order.address,
    parcel: { weight_oz: order.weight_oz }
  });

  if (rates.rates.length === 0) {
    throw new Error('No rates available');
  }

  // 2. Buy cheapest label
  const label = await pr.labels.create({
    rate_id: rates.rates[0].id
  });

  return {
    tracking: label.tracking_number,
    labelPdf: label.label_url,
    cost: label.rate_cents
  };
}