Bowmark AIdocs

USPS

USPS's own Retail Postage Price Calculator (postcalc.usps.com) — prices a domestic package across every USPS Mail Service that quotes it for a ZIP-to-ZIP…

USPS's own Retail Postage Price Calculator (postcalc.usps.com) — prices a domestic package across every USPS Mail Service that quotes it for a ZIP-to-ZIP move, weight and optional dimensions, and returns the counter price, the discounted Click-N-Ship price and USPS's own delivery-commitment date. One keyless GET to the calculator's own JSON endpoint. No key, no browser.

Domain: usps.com

Also known as: USPS, United States Postal Service, usps.com, Postal Service

Prefer the capability

bowmark.shipping covers this provider and routes around it when it is having a bad day. Reach for this page when you need usps.com specifically.

Call it directly

bowmark.providers.usps.getRate(args: { fromZip: string; toZip: string; weightOz: number; length?: number; width?: number; height?: number }): Promise<uspsRateOption[]>

Functions

FunctionWhat it does
getRatePrices a domestic package across every USPS Mail Service that quotes it, between two 5-digit ZIP Codes, for a weight in ounces and optional length/width/height in inches (all three or…

Types

interface uspsRateOption {
  postageServiceId: number;
  description: string;
  price: number;
  commercialPrice: number | null;
  deliveryDay: string | null;
  flatRateBox: string | null;
}

Examples

const rates = await bowmark.providers.usps.getRate({ fromZip: "20024", toZip: "10001", weightOz: 16 });
// rates[0] -> { postageServiceId: 58, description: "USPS Ground Advantage®", price: 10.2,
//               commercialPrice: 8, deliveryDay: "Tue, Sep 1", flatRateBox: null }
shippingShipping rate estimate — the capability this provider backs.
upsAlso backs the same capability.