1. Shipments
  2. Rates

Shipments

Rates

Rate Model

This is how all rates are returned on the platform. Initially when you are creating rates, you'll typically have many options here. When it's time to purchase the rate, you'll pass the id of the rate you want to buy.


object "rate"
The description of the model.

type String
The type of rate. Can be one of delivery, pickup, or received. Defaults to delivery.

created_at Integer
Time in epoch seconds when this rate was created.

id String
Unique identifier for the rate, prefixed with rate_

amount integer
The total cost of the rate that will be displayed.

billed_amount integer
The actual amount you will be charged when purchasing this rate. Can be higher or lower than the amount if you are discounting or upcharging your shipment.

retail_amount integer
The retail price of the rate.

provider object
The carrier or courier details for this rate.

Show Details
provider.name string
Name of the provider
provider.id string
Unique ID for the provider
provider.logo_url string
Logo of the provider
provider.support_phone string
Support phone number for the provider's customer service, available for on demand couriers
provider.support_email string
Support email for the provider's customer service, available for on demand couriers
provider.support_url string
Support website for the provider's customer service, available for on demand couriers
provider.support_reference string
Reference number used for support inquiries with the provider

service_level object
Details about the delivery service for this rate.

Show Details
service_level.id String
The ID of the service level. For a complete list of available service level identifiers, see Service Levels
service_level.rate_type String
The type of rate for this service level. Can be one of: delivery, pickup, or received
service_level.name String
The name of the service level for customers to understand, e.g: Same Day or Next Day Early
service_level.terms string
Human-readable description of the service, such as "Same day delivery, typically before 9pm
service_level.days integer
The expected days that this delivery will take
service_level.estimated_delivery_at integer
Estimated delivery time in epoch seconds, calculated using the service level's default days and time.
Will be null for pickup rates
service_level.pickup_at Integer
Scheduled pickup time in epoch seconds. Only set for rates that include pickup service