1. Shipments
  2. Providers & Service

Shipments

Providers & Service

The PackageX platform supports fetching shipping rates from standard shipping providers and private rates that you set only for yourself.

Providers

Public providers are the ones that can be toggled on and off on your dashboard. All rates returned from these providers will be of type: provider_delivery. Below is the current public list:

Special Cases

There are two reserved IDs that also act as providers.

self

You yourself can be a shipping provider in a few ways:

  1. You are an approved shipping provider on the PackageX marketplace
  2. You have set up private rates via the API or the Deliver App.

The self keyword only targets your private rates as it relates to filtering shipping rates after creating a shipment or fulfillment.

marketplace

There are hundreds of thousands of independent operated shipping provers across the US and even more internationally. The PackageX shipment API gives access to these providers using the ID marketplace.

Names & IDs

Name ID Type
-- self This will get your private rates
-- marketplace PackageX Marketplace Providers
Burq burq On demand
DoorDash doordash On demand
FedEx fedex Multinational
UPS ups Multinational
USPS usps US Domestic


Service Levels

Every provider with which we work can return multiple rates for a shipment, as long as each rate has a unique service level. When creating a shipment or a fulfillment, you can indicate how you would like these service levels to be pre-filtered.

Self

When targeting self there can be any number or rates returned depending on how many private rates you have set up. These rates will have dynamic IDs which can be queried like this:

js
const response = await fetch("https://api.packagex.io/v1/org", {
  method: "GET",
  headers: {
    "PX-API-KEY": process.env.PX_API_KEY,
    "Content-Type": "application/json",
  },
}).then(res.json());

const deliveries_settings = response.data.settings.deliveries;
const private_rate_ids = deliveries_settings.private_rates.map((rate) => rate.id);
Service Level Name ID Description
Custom Name pr_... Whatever rate you entered.

Marketplace

Service Level Name ID Description
Two Hour two_hour Two hour delivery after pickup
Same Day same_day Delivery by 10pm

Burq

Service Level Name ID Description
On Demand on_demand Pickup and dropoff ASAP

DoorDash

Service Level Name ID Description
On Demand on_demand Pickup and dropoff ASAP

FedEx

Service Level Name ID Description
First Overnight first_overnight Delivery by next business day morning, typically 8am - 9:30am. Some areas guaranteed up to 2pm
Priority Overnight priority_overnight Next business day delivery by 10:30am to most businesses, noon to residences, and 4:30pm so some rural areas
Standard Overnight standard_overnight Next business day delivery by 4:30pm to businesses and 8pm to residences
FedEx 2 Day AM fedex_2_day_am 2 day shipping , delivered before noon
FedEx 2 Day fedex_2_day 2 day shipping
FedEx Express Saver fedex_express_saver 3 day shipping
FedEx Ground fedex_ground 1-5 business day shipping (3-7 to Alaska and Hawaii)

UPS

Service Level Name ID Description
Next Day Air Early AM next_day_air_early_am Guaranteed delivery by 8am to major cities and typically 8:30am - 9:30am to most cities
Next Day Air next_day_air Guaranteed delivery by 10:30 a.m., 12 p.m. or the end of the day, depending on the destination
Next Day Air Saver next_day_air_saver Guaranteed delivery by 3 p.m. or 4:30 p.m. to most commercial destinations
2 Day Air AM 2nd_day_air_am Guaranteed 2 day delivery by 10:30 a.m. or 12 p.m. to most commercial destinations
2 Day Air 2nd_day_air Guaranteed delivery by the end of the day, including Saturday delivery for shipments picked up on Thursday
3 Day Select 3_day_select Guaranteed delivery by the end of the third business day
Ground ground 1-5 business day shipping

USPS

Service Level Name ID Description
First first 1-5 day delivery
Priority priority 1-3 day delivery
Express express 1-2 day delivery by 6pm
Parcel Select parcel_select 2-8 day delivery