Rate shopping profiles
What a rate shopping profile is and how to use it when creating shipments.
What a rate shopping profile is
A rate shopping profile is a named shipping configuration on your account. It defines the carriers you can ship with, the origin locations they ship from, the service levels they offer, and the negotiated rates behind them one complete shipping setup, bundled under a single identifier.
An account can have more than one. Each represents a distinct shipping strategy for example, a cost-optimized ground setup and a faster expedited one and you choose which applies to a given shipment.
How you use it
When you create a shipment, Parsel rate-shops it against one profile, comparing that profile's carriers and service levels and picking a rate. You choose which profile applies by passing its profile_key as the rate_shopping_profile field on POST /shipments.
A profile zip_coverage is the set of destination ZIP codes its carriers can deliver to useful for checking whether a destination is serviceable before you create a shipment.
Reading profiles
The API is read-only and scoped to your account:
- List rate-shopping profiles
GET /rate_shopping_profiles, the profiles available to you. - Get a rate-shopping profile
GET /rate_shopping_profiles/{profile_key}, one profile including itszip_coverage.