Sendbox API Documentation
  • Introduction
  • API
    • Basics
    • Errors
  • Authentication
    • Authentication
  • Shipping
    • Introduction
    • Get Shipments
    • Get Shipment
    • Request Shipping Quotes
    • Create New Shipment
    • Calculate Landed Cost
    • Tracking Shipment
    • Saved Addresses
  • Payment
    • Introduction
    • Payment Profile
    • Virtual Account
  • third party intergations
    • WooCommerce Plugin
    • Opencart Extension
    • Shopify
    • Magento
  • Webhooks
    • WooCommerce
  • Webhooks
    • WooCommerce
Powered by GitBook
On this page

Was this helpful?

  1. Shipping

Request Shipping Quotes

Getting shipment quotes requires you making a post request to the shipment delivery quote endpoint ensure to pass the required header parameters and body parameters to get the appropriate response.

A sample payload to request shipment quotes

{
        "origin" : {
            "first_name" : "Will",
            "last_name" : "Smith",
            "street" : "10 Olasheun Crescent",
            "street_line_2" : "HQ",
            "state" : "Lagos",
            "email" : null,
            "city" : "Obanikoro",
            "country" : "NG",
            "post_code" : "102216",
            "phone" : "+234 800 666 0419",
            "lng" : 3.37,
            "lat" : 6.56,
            "name" : null
        },
    "destination": {
        "first_name": "Joe",
        "last_name": "Goldberg",
        "post_code": "94612",
        "phone": "+1 267 000 0",
        "lng": -122.27,
        "lat": 37.81,
        "name": null,
        "street": "31 Hall Crescent",
        "street_line_2": "",
        "state": "paris",
        "email": "",
        "city": "paris",
        "country": "FR"
    },
    "weight" : 2,
        "dimension" : {
            "length" : 1,
            "width" : 1,
            "height" : 1
        },
        "incoming_option" : "pickup",
        "region" : "NG",
        "service_type" : "international",
        "package_type" : "general",
        "total_value" : 15000,
        "currency" : "NGN",
        "channel_code" : "api",
        "pickup_date" : "2023-07-20",
        "items" : [
            {
                "item_type" : "snail",
                "hts_code": "9001.21",
                "quantity" : 2,
                "name" : "African Wax Fabrics - Orange Lace Fabric that is Not Woven",
                "value" : 1500
            }
        ],
        "service_code": "standard",
        "customs_option": "recipient"
}

Adding currency to the shipping quotes payload will return quotes in whatever currency that was passed.

Service code value can be either one of the following: standard, premium or expedient. You can default it in your request.

Staging URL: Staging URL: https://sandbox.staging.sendbox.co/shipping/shipment_delivery_quote

Get Shipping Quotes

https://live.sendbox.co/shipping/shipment_delivery_quote

This gets shipping quotes

Headers

Name

Type

Description

Authorization

String

Authorization-key

Content-type

String

application/json

Body Parameters

Name

Type

Description

origin

object

senders details

destination

object

recipient details

currency

String

shop currency

weight

float

weight of package

dimension

object

dimension details

incoming_option

string

incoming option can be pick up or drop off

region

string

what region is the package is shipped from

service_type

string

set to either international or local

package_type

string

package type

total_value

float

value of shipment

channel_code

string

channel the request is being made from in this case set it to api

pickup_date

string

date package is picked up

items

array

An array of objects that contain:

- name [String]

- weight [Float]

- item_type_code [String optional]

- hts_code [String optional]

- description [String]

- quantity [Integer]

- value [Float]

service_code

string

can be set to international, local or nation-wide

customs_option

string

custom options

201: Created

Shipping quotes returns the different available couriers and their price rated for this particular shipment.

{
    "items": [
        {
            "value": 1500.0,
            "quantity": 2,
            "item_type": "zips",
            "name": "African Wax Fabrics - Orange Lace Fabric that is Not Woven",
            "hts_code": null,
            "disclaim": false
        }
    ],
    "rates": [
        {
            "fee": 30617.0,
            "key": "65901e2c2291eb2af1f23b4f",
            "insurance_option": "standard",
            "applied_credits": 0.0,
            "insurance_fee": 300.0,
            "breakdown": [
                {
                    "value": 28180.93,
                    "code": "base_fee",
                    "name": "Base Fee",
                    "description": "Base Fee"
                },
                {
                    "value": 2136.07,
                    "code": "vat",
                    "name": "Vat",
                    "description": "Vat"
                },
                {
                    "value": 300.0,
                    "code": "insurance_fee",
                    "name": "Insurance Fee",
                    "description": "Insurance Fee"
                },
                {
                    "value": 0,
                    "code": "applied_credits",
                    "name": "Credits",
                    "description": "Credits"
                },
                {
                    "value": 0,
                    "code": "discount_fee",
                    "name": "Discount",
                    "description": "Discount"
                }
            ],
            "delivery_window": "Before 6PM Wednesday",
            "is_enabled": true,
            "caption": "",
            "currency": "NGN",
            "additional_fee": 0.0,
            "insurance_cap": 300.0,
            "delivery_date": "2024-08-21 16:59:03.560544",
            "discount_fee": 0.0,
            "pickup_eta_string": "11AM - 2PM Wednesday",
            "rate_card_id": "65901e2c2291eb2af1f23b4f",
            "sla_description": "Up to 8 working days",
            "base_fee": 28180.93,
            "description": "Standard",
            "vat": 2136.07,
            "pickup_date": "2024-08-14 14:00:03.560544",
            "pickup_window": "11AM - 2PM Wednesday",
            "name": "Standard",
            "rate_type": "standard",
            "volumetric_weight": 0.5,
            "code": "standard",
            "customs_options": [
                "recipient"
            ],
            "billable_weight": 2.0,
            "service_code": "standard",
            "delivery_eta_string": "Before 6PM Wednesday"
        },
        {
            "fee": 34894.0,
            "insurance_option": "standard",
            "applied_credits": 0.0,
            "insurance_fee": 300.0,
            "breakdown": [
                {
                    "value": 32159.53,
                    "code": "base_fee",
                    "name": "Base Fee",
                    "description": "Base Fee"
                },
                {
                    "value": 2434.47,
                    "code": "vat",
                    "name": "Vat",
                    "description": "Vat"
                },
                {
                    "value": 300.0,
                    "code": "insurance_fee",
                    "name": "Insurance Fee",
                    "description": "Insurance Fee"
                },
                {
                    "value": 0,
                    "code": "applied_credits",
                    "name": "Credits",
                    "description": "Credits"
                },
                {
                    "value": 0,
                    "code": "discount_fee",
                    "name": "Discount",
                    "description": "Discount"
                }
            ],
            "delivery_window": "Before 6PM Wednesday",
            "is_enabled": true,
            "caption": "faster delivery",
            "currency": "NGN",
            "additional_fee": 0.0,
            "insurance_cap": 300.0,
            "delivery_date": "2024-08-21 16:59:03.647071",
            "discount_fee": 0.0,
            "pickup_eta_string": "11AM - 2PM Wednesday",
            "rate_card_id": "6594a8914c03ff6e6170ac73",
            "sla_description": "5 to 7 working days, Recommended",
            "base_fee": 32159.53,
            "description": "Premium",
            "vat": 2434.47,
            "pickup_date": "2024-08-14 14:00:03.647071",
            "pickup_window": "11AM - 2PM Wednesday",
            "name": "Premium",
            "rate_type": "premium",
            "volumetric_weight": 0.5,
            "code": "premium",
            "customs_options": [
                "recipient"
            ],
            "billable_weight": 2.0,
            "service_code": "premium",
            "delivery_eta_string": "Before 6PM Wednesday"
        },
        {
            "fee": 44061.0,
            "insurance_option": "standard",
            "applied_credits": 0.0,
            "insurance_fee": 300.0,
            "breakdown": [
                {
                    "value": 40686.97,
                    "code": "base_fee",
                    "name": "Base Fee",
                    "description": "Base Fee"
                },
                {
                    "value": 3074.03,
                    "code": "vat",
                    "name": "Vat",
                    "description": "Vat"
                },
                {
                    "value": 300.0,
                    "code": "insurance_fee",
                    "name": "Insurance Fee",
                    "description": "Insurance Fee"
                },
                {
                    "value": 0,
                    "code": "applied_credits",
                    "name": "Credits",
                    "description": "Credits"
                },
                {
                    "value": 0,
                    "code": "discount_fee",
                    "name": "Discount",
                    "description": "Discount"
                }
            ],
            "delivery_window": "Before 6PM Wednesday",
            "is_enabled": true,
            "caption": "faster delivery",
            "currency": "NGN",
            "additional_fee": 0.0,
            "insurance_cap": 300.0,
            "delivery_date": "2024-08-21 16:59:03.681974",
            "discount_fee": 0.0,
            "pickup_eta_string": "11AM - 2PM Wednesday",
            "rate_card_id": "6594a91f4c03ff6e6170ac83",
            "sla_description": "Up to 5 working days, Fastest",
            "base_fee": 40686.97,
            "description": "Expedited",
            "vat": 3074.03,
            "pickup_date": "2024-08-14 14:00:03.681974",
            "pickup_window": "11AM - 2PM Wednesday",
            "name": "Expedited",
            "rate_type": "expedited",
            "volumetric_weight": 0.5,
            "code": "expedited",
            "customs_options": [
                "recipient"
            ],
            "billable_weight": 2.0,
            "service_code": "expedited",
            "delivery_eta_string": "Before 6PM Wednesday"
        }
    ],
    "destination": {
        "country": "FR",
        "city": "paris",
        "post_code": "94612",
        "state": "paris",
        "lng": -122.27,
        "lat": 37.81
    },
    "rate_type": "standard",
    "status": "successful",
    "currency": "NGN",
    "service_type": "international",
    "rate": {
        "fee": 30617.0,
        "key": "65901e2c2291eb2af1f23b4f",
        "insurance_option": "standard",
        "applied_credits": 0.0,
        "insurance_fee": 300.0,
        "breakdown": [
            {
                "value": 28180.93,
                "code": "base_fee",
                "name": "Base Fee",
                "description": "Base Fee"
            },
            {
                "value": 2136.07,
                "code": "vat",
                "name": "Vat",
                "description": "Vat"
            },
            {
                "value": 300.0,
                "code": "insurance_fee",
                "name": "Insurance Fee",
                "description": "Insurance Fee"
            },
            {
                "value": 0,
                "code": "applied_credits",
                "name": "Credits",
                "description": "Credits"
            },
            {
                "value": 0,
                "code": "discount_fee",
                "name": "Discount",
                "description": "Discount"
            }
        ],
        "delivery_window": "Before 6PM Wednesday",
        "is_enabled": true,
        "caption": "",
        "currency": "NGN",
        "additional_fee": 0.0,
        "insurance_cap": 300.0,
        "delivery_date": "2024-08-21 16:59:03.560544",
        "discount_fee": 0.0,
        "pickup_eta_string": "11AM - 2PM Wednesday",
        "rate_card_id": "65901e2c2291eb2af1f23b4f",
        "sla_description": "Up to 8 working days",
        "base_fee": 28180.93,
        "description": "Standard",
        "vat": 2136.07,
        "pickup_date": "2024-08-14 14:00:03.560544",
        "pickup_window": "11AM - 2PM Wednesday",
        "name": "Standard",
        "rate_type": "standard",
        "volumetric_weight": 0.5,
        "code": "standard",
        "customs_options": [
            "recipient"
        ],
        "billable_weight": 2.0,
        "service_code": "standard",
        "delivery_eta_string": "Before 6PM Wednesday"
    },
    "origin": {
        "country": "NG",
        "city": "obanikoro",
        "post_code": "102216",
        "state": "lagos",
        "lng": 3.37,
        "lat": 6.56
    },
    "region": "NG",
    "service_code": "standard",
    "weight": 2.0,
    "connector_rates": [],
    "package_type": "general"
}

PreviousGet ShipmentNextCreate New Shipment

Last updated 8 months ago

Was this helpful?