API ReferenceDocs
API Reference
Dashboard
Start typing to search…

Request Rates

post
https://public-api.easyship.com/2024-09/rates

Request a list of shipping quotes for a prospective shipment.

Required authorization scope: public.rate:read

Compare couriers to see the cheapest, fastest and best value for money, or a combination of speed, price and reliability.

Input city and state

If you are shipping to or within the United States, Canada, Mexico or Australia, we recommend that you always input the origin and destination city and state. This information is required by certain couriers to return accurate rates.

Calculate dimensions and total weight

You can calculate dimensions and total weight of your shipment in three ways:

  • Provide total_actual_weight and box objects for the shipment.
  • Specify actual_weight and dimensions for each item of the items object: in this case, total weight and box size will be calculated automatically.
  • Specify sku for each item of the items object: in this case, actual weight and dimensions for calculations will be taken as set for the product.

Note: Calls to this endpoint count towards your API usage allowance. You can monitor your current usage in the Subscription section of your account.

Body Params
origin_address
object
required

Origin Address

destination_address
object
required

Destination Address

boolean

US addresses will be automatically validated when not specified. If specified, the validation will be bypassed.

string | null
enum
Defaults to DDU

Terms of Sale DDP: Seller pays all import duties/taxes. DDU: Buyer pays all import duties/taxes. null: No incoterm specified; defaults to DDU.

Allowed:
insurance
object | null

Insurance

boolean

Set the shipment as a return shipment

courier_settings
object
shipping_settings
object
parcels
array of objects
required
length ≥ 1

Parcels

parcels*
number

Total weight of the shipment, including the box weight. If you provide the total weight of the shipment, then the weight for items can be optional.

box
object | null

The box dimensions for the shipment. If the box dimensions are provided, then dimensions for items are optional.

items
array
length between 1 and 200

Array of all shipment items

items
string
≤ 200

Description of the item.

string | null
≤ 200

Item category name or slug. Required if hs_code is not provided. Use the Item Categories API to retrieve a list of available item categories.

string

HS Code of the item. Required if category is not provided.

string
≤ 100

Item Stock Keeping Unit (SKU) as listed in your store.

boolean | null

Whether the item contains a PI966 battery (applicable when HS code is used).

boolean | null

Whether the item contains a PI967 battery (applicable when HS code is used).

boolean | null

Whether the item contains liquids (applicable when HS code is used).

string | null
enum

Country Code in Alpha-2 format (ISO 3166-1)

integer
Defaults to 1

Item quantity

dimensions
object

Dimensions of the item

number

Item actual weight in kg. Must be greater than 0. Optional when total_actual_weight is provided. Required when the shipping rule action split_parcels_by_sku is enabled, regardless of the existence of total_actual_weight

string
enum
required

Item currency. ISO-4217 three-letter alphabetic currency code (e.g. USD, EUR, GBP).

number
required

Item customs value, must be greater than 0 unless category is documents. Please note that this value refers to the unit rather than the total.

boolean
Defaults to true

Whether to calculate taxes and duties for international shipments. Must be true when using DDP Incoterms. When set to true, the response will include estimated import tax and duty charges. When set to false, tax and duty calculations will be skipped.

filter_options
object

Filter response by keywords

Responses

Updated 2 months ago

Language
Credentials
Bearer
token
Response 
Click Try It! to start a request and see the response here! Or choose an example:
application/json
Updated 2 months ago