Request shipping rates
Things to note:
Shipment rates requested after 6 PM (GMT +1) will be scheduled for processing the following day.
You can only request a shipment for a maximum of 7 days from the current date of request.
The successful rate response will indicate which courier is the cheapest, fastest, and best value for money, which is a combination of speed, price, and reliability.
A rate request token expires after 7 days of generation.
For your package items
Strive to be as accurate as possible when shipping! The more accurate your information is, the better the rate quote you will receive from the couriers.
Additionally, if the shipping information is incorrect, most carriers will follow up with a charge to make up the difference.
POST
https://api.shipbubble.com/v1/shipping/fetch_rates
Request Body
sender_address_code*
int
address code of label pickup (gotten from Addresses API)
reciever_address_code*
int
address code of label pickup (gotten from Addresses API)
pickup_date*
string
specified date for shipment processing(format: "yyyy-mm-dd")
category_id*
int
package item category
package_items*
Array
An array of items to be shipped, a sample package item object looks like { name:'Jameson', description:'Too sweet', unit_weight:'0.002', unit_amount:'5000', quantity:'2' }
, all object items are required, item weight unit is in KG
service_type
string
filter rates by their service types ex. dropoff or pickup
delivery_instructions
string
additional delivery instructions for package
package_dimension*
Object
Dimension pf package to be delivered (in CM), if you are not sure of your dimension, you can make use of the Package Dimensions API
{ "length":12, "width":10, "height":10 }
Some key fields returned in the courier rates array
rate_card_amount
The amount to be displayed to your customer as shipping cost. It's always the same value as the total field, only in cases where the courier account chosen is your connected courier.
total
The amount that will be charged from your shipping wallet for the delivery.
pickup_eta_time
Estimated time frame within which the package will be picked up.
delivery_eta_time
Estimated time frame within which the package will be delivered.
is_cod_available
Indicates if cash on delivery option is available for the rate returned. If true, cod_fee will contain a service charge of the cod offering.
tracking_level
Indicates how responsive the tracking systems of the courier rates are, ranging from 1 - 10.
Last updated
Was this helpful?