Basics
- All request should be issued using HTTP protocol
- All request requires authentication
- Content type for responses will always be
application/json
To construct an API request the following components are required.
Component | Description |
The HTTP method | GET. Request data from resourcePOST . Submit data to a resource to process PUT . Update a resource DELETE . Deletes a resource |
The URL to the staging API service | |
The URL to the live API service | |
HTTP request header | Includes the Content-type header with the value application/json |
A JSON request body | required for making a request |
You are advised to make all test request on the staging API and ensure there are no errors before you deploy to users using the live API
This describes the response format for Sendbox API
Sendbox API calls return HTTP status codes in the response headers. API calls also return JSON response bodies that include information about the resource.
Each REST API request returns a success or error HTTP status code.we will talk about errors latter in the docs but for now, we will focus on success.
status code | Description |
200 | A successful GET request |
201 | A successful POST, PUT request means your request is created or updated. |
Fetching data means you will like to retrieve data from a resource. Most times, you are required to set header parameters usually the content-type and the authorization key and make a get request to an endpoint. For example, let say we want to get all shipments, we can simply make a get request and a successful request will come back with a 200 status code and return all the shipments in JSON format.
In this example, we are making a get request to shipment endpoint to fetch all shipments
Request
Response
200: OK
The response body is always in
JSON format. It contains all shipments details {
"next_page": "?page=2",
"prev": null,
"page_by": {
"total": 79,
"pages": 4,
"next": 2,
"per_page": 20,
"prev": null,
"page": 1
},
"print_string": "U0VMRUNUIHNoaXBtZW50LmlkIEFTIHNoaXBtZW50X2lkLCBzaGlwbWVudC5jb2RlIEFTIHNoaXBtZW50X2NvZGUsIHNoaXBtZW50LnJlZmVyZW5jZV9jb2RlIEFTIHNoaXBtZW50X3JlZmVyZW5jZV9jb2RlLCBzaGlwbWVudC5ub3RlcyBBUyBzaGlwbWVudF9ub3Rlcywgc2hpcG1lbnQuYmFyY29kZSBBUyBzaGlwbWVudF9iYXJjb2RlLCBzaGlwbWVudC5hd2Jfbm8gQVMgc2hpcG1lbnRfYXdiX25vLCBzaGlwbWVudC5hd2JfZW5kcG9pbnQgQVMgc2hpcG1lbnRfYXdiX2VuZHBvaW50LCBzaGlwbWVudC5wYWNrYWdlX3R5cGVfY29kZSBBUyBzaGlwbWVudF9wYWNrYWdlX3R5cGVfY29kZSwgc2hpcG1lbnQub3JpZ2luX21lcmNoYW50X2lkIEFTIHNoaXBtZW50X29yaWdpbl9tZXJjaGFudF9pZCwgc2hpcG1lbnQub3JpZ2luX25hbWUgQVMgc2hpcG1lbnRfb3JpZ2luX25hbWUsIHNoaXBtZW50Lm9yaWdpbl9waG9uZSBBUyBzaGlwbWVudF9vcmlnaW5fcGhvbmUsIHNoaXBtZW50Lm9yaWdpbl9lbWFpbCBBUyBzaGlwbWVudF9vcmlnaW5fZW1haWwsIHNoaXBtZW50Lm9yaWdpbl9zdHJlZXQgQVMgc2hpcG1lbnRfb3JpZ2luX3N0cmVldCwgc2hpcG1lbnQub3JpZ2luX2NpdHkgQVMgc2hpcG1lbnRfb3JpZ2luX2NpdHksIHNoaXBtZW50Lm9yaWdpbl9jaXR5X2lkIEFTIHNoaXBtZW50X29yaWdpbl9jaXR5X2lkLCBzaGlwbWVudC5vcmlnaW5fbGF0IEFTIHNoaXBtZW50X29yaWdpbl9sYXQsIHNoaXBtZW50Lm9yaWdpbl9sbmcgQVMgc2hpcG1lbnRfb3JpZ2luX2xuZywgc2hpcG1lbnQub3JpZ2luX3Bvc3RfY29kZSBBUyBzaGlwbWVudF9vcmlnaW5fcG9zdF9jb2RlLCBzaGlwbWVudC5vcmlnaW5fc3RhdGVfY29kZSBBUyBzaGlwbWVudF9vcmlnaW5fc3RhdGVfY29kZSwgc2hpcG1lbnQub3JpZ2luX2NvdW50cnlfY29kZSBBUyBzaGlwbWVudF9vcmlnaW5fY291bnRyeV9jb2RlLCBzaGlwbWVudC5kZXN0aW5hdGlvbl9tZXJjaGFudF9pZCBBUyBzaGlwbWVudF9kZXN0aW5hdGlvbl9tZXJjaGFudF9pZCwgc2hpcG1lbnQuZGVzdGluYXRpb25fbmFtZSBBUyBzaGlwbWVudF9kZXN0aW5hdGlvbl9uYW1lLCBzaGlwbWVudC5kZXN0aW5hdGlvbl9waG9uZSBBUyBzaGlwbWVudF9kZXN0aW5hdGlvbl9waG9uZSwgc2hpcG1lbnQuZGVzdGluYXRpb25fZW1haWwgQVMgc2hpcG1lbnRfZGVzdGluYXRpb25fZW1haWwsIHNoaXBtZW50LmRlc3RpbmF0aW9uX3N0cmVldCBBUyBzaGlwbWVudF9kZXN0aW5hdGlvbl9zdHJlZXQsIHNoaXBtZW50LmRlc3RpbmF0aW9uX2NpdHkgQVMgc2hpcG1lbnRfZGVzdGluYXRpb25fY2l0eSwgc2hpcG1lbnQuZGVzdGluYXRpb25fbGF0IEFTIHNoaXBtZW50X2Rlc3RpbmF0aW9uX2xhdCwgc2hpcG1lbnQuZGVzdGluYXRpb25fbG5nIEFTIHNoaXBtZW50X2Rlc3RpbmF0aW9uX2xuZywgc2hpcG1lbnQuZGVzdGluYXRpb25fcG9zdF9jb2RlIEFTIHNoaXBtZW50X2Rlc3RpbmF0aW9uX3Bvc3RfY29kZSwgc2hpcG1lbnQuZGVzdGluYXRpb25fc3RhdGVfY29kZSBBUyBzaGlwbWVudF9kZXN0aW5hdGlvbl9zdGF0ZV9jb2RlLCBzaGlwbWVudC5kZXN0aW5hdGlvbl9jb3VudHJ5X2NvZGUgQVMgc2hpcG1lbnRfZGVzdGluYXRpb25fY291bnRyeV9jb2RlLCBzaGlwbWVudC50aW1lX3NjaGVkdWxlX2NvZGUgQVMgc2hpcG1lbnRfdGltZV9zY2hlZHVsZV9jb2RlLCBzaGlwbWVudC5hY2NlcHRfdmFsdWVfb25fZGVsaXZlcnkgQVMgc2hpcG1lbnRfYWNjZXB0X3ZhbHVlX29uX2RlbGl2ZXJ5LCBzaGlwbWVudC50b3RhbF92YWx1ZSBBUyBzaGlwbWVudF90b3RhbF92YWx1ZSwgc2hpcG1lbnQuYW1vdW50X3RvX3JlY2VpdmUgQVMgc2hpcG1lbnRfYW1vdW50X3RvX3JlY2VpdmUsIHNoaXBtZW50LnBpY2t1cF9ldGEgQVMgc2hpcG1lbnRfcGlja3VwX2V0YSwgc2hpcG1lbnQubGFzdF9kaXNwYXRjaF90aW1lIEFTIHNoaXBtZW50X2xhc3RfZGlzcGF0Y2hfdGltZSwgc2hpcG1lbnQuYWNjZXB0X2N1c3RvbV9mZWUgQVMgc2hpcG1lbnRfYWNjZXB0X2N1c3RvbV9mZWUsIHNoaXBtZW50LnJhdGVfZmVlIEFTIHNoaXBtZW50X3JhdGVfZmVlLCBzaGlwbWVudC5jdXN0b21fZmVlIEFTIHNoaXBtZW50X2N1c3RvbV9mZWUsIHNoaXBtZW50LmRpc2NvdW50X2ZlZSBBUyBzaGlwbWVudF9kaXNjb3VudF9mZWUsIHNoaXBtZW50LmZlZSBBUyBzaGlwbWVudF9mZWUsIHNoaXBtZW50LmZlZV9iYWxhbmNlIEFTIHNoaXBtZW50X2ZlZV9iYWxhbmNlLCBzaGlwbWVudC5wYWlkIEFTIHNoaXBtZW50X3BhaWQsIHNoaXBtZW50LnByaW9yaXR5X3BpY2t1cF9mZWUgQVMgc2hpcG1lbnRfcHJpb3JpdHlfcGlja3VwX2ZlZSwgc2hpcG1lbnQuZGlzY291bnQgQVMgc2hpcG1lbnRfZGlzY291bnQsIHNoaXBtZW50LnZhdCBBUyBzaGlwbWVudF92YXQsIHNoaXBtZW50LmZlZV9wYXltZW50X3N0YXR1c19jb2RlIEFTIHNoaXBtZW50X2ZlZV9wYXltZW50X3N0YXR1c19jb2RlLCBzaGlwbWVudC5mZWVfcGF5bWVudF9jaGFubmVsX2NvZGUgQVMgc2hpcG1lbnRfZmVlX3BheW1lbnRfY2hhbm5lbF9jb2RlLCBzaGlwbWVudC5wYXlfb25fZGVsaXZlcnlfbWV0aG9kX2NvZGUgQVMgc2hpcG1lbnRfcGF5X29uX2RlbGl2ZXJ5X21ldGhvZF9jb2RlLCBzaGlwbWVudC50cmFuc2FjdGlvbl9jb2RlIEFTIHNoaXBtZW50X3RyYW5zYWN0aW9uX2NvZGUsIHNoaXBtZW50LnRyYW5zYWN0aW9uX2lkIEFTIHNoaXBtZW50X3RyYW5zYWN0aW9uX2lkLCBzaGlwbWVudC5pbnN0cnVjdGlvbl9jb2RlIEFTIHNoaXBtZW50X2luc3RydWN0aW9uX2NvZGUsIHNoaXBtZW50Lmxlbmd0aCBBUyBzaGlwbWVudF9sZW5ndGgsIHNoaXBtZW50LndpZHRoIEFTIHNoaXBtZW50X3dpZHRoLCBzaGlwbWVudC5oZWlnaHQgQVMgc2hpcG1lbnRfaGVpZ2h0LCBzaGlwbWVudC53ZWlnaHQgQVMgc2hpcG1lbnRfd2VpZ2h0LCBzaGlwbWVudC51c2VyX3dlaWdodCBBUyBzaGlwbWVudF91c2VyX3dlaWdodCwgc2hpcG1lbnQucXVhbnRpdHkgQVMgc2hpcG1lbnRfcXVhbnRpdHksIHNoaXBtZW50LmlzX2ZyYWdpbGUgQVMgc2hpcG1lbnRfaXNfZnJhZ2lsZSwgc2hpcG1lbnQuaXNfc3BpbGxhYmxlIEFTIHNoaXBtZW50X2lzX3NwaWxsYWJsZSwgc2hpcG1lbnQuaXNfY29uZmlkZW50aWFsIEFTIHNoaXBtZW50X2lzX2NvbmZpZGVudGlhbCwgc2hpcG1lbnQuY291cmllcl9pZCBBUyBzaGlwbWVudF9jb3VyaWVyX2lkLCBzaGlwbWVudC5hZ2VudF9pZCBBUyBzaGlwbWVudF9hZ2VudF9pZCwgc2hpcG1lbnQuY2xpZW50X2lkIEFTIHNoaXBtZW50X2NsaWVudF9pZCwgc2hpcG1lbnQubWVyY2hhbnRfaWQgQVMgc2hpcG1lbnRfbWVyY2hhbnRfaWQsIHNoaXBtZW50LmNoYW5uZWxfY29kZSBBUyBzaGlwbWVudF9jaGFubmVsX2NvZGUsIHNoaXBtZW50LnBpY2t1cF9kYXRlIEFTIHNoaXBtZW50X3BpY2t1cF9kYXRlLCBzaGlwbWVudC5pbmNvbWluZ19vcHRpb25fY29kZSBBUyBzaGlwbWVudF9pbmNvbWluZ19vcHRpb25fY29kZSwgc2hpcG1lbnQuZGVsaXZlcnlfdHlwZV9jb2RlIEFTIHNoaXBtZW50X2RlbGl2ZXJ5X3R5cGVfY29kZSwgc2hpcG1lbnQuZGVsaXZlcnlfcHJpb3JpdHlfY29kZSBBUyBzaGlwbWVudF9kZWxpdmVyeV9wcmlvcml0eV9jb2RlLCBzaGlwbWVudC5wYXltZW50X29wdGlvbl9jb2RlIEFTIHNoaXBtZW50X3BheW1lbnRfb3B0aW9uX2NvZGUsIHNoaXBtZW50Lm1pbl9xdW90ZWRfZmVlIEFTIHNoaXBtZW50X21pbl9xdW90ZWRfZmVlLCBzaGlwbWVudC5tYXhfcXVvdGVkX2ZlZSBBUyBzaGlwbWVudF9tYXhfcXVvdGVkX2ZlZSwgc2hpcG1lbnQuZGlzY291bnRfbWluX3F1b3RlZF9mZWUgQVMgc2hpcG1lbnRfZGlzY291bnRfbWluX3F1b3RlZF9mZWUsIHNoaXBtZW50LmRpc2NvdW50X21heF9xdW90ZWRfZmVlIEFTIHNoaXBtZW50X2Rpc2NvdW50X21heF9xdW90ZWRfZmVlLCBzaGlwbWVudC5zdGF0dXNfY29kZSBBUyBzaGlwbWVudF9zdGF0dXNfY29kZSwgc2hpcG1lbnQuZGVsaXZlcnlfY2FsbGJhY2sgQVMgc2hpcG1lbnRfZGVsaXZlcnlfY2FsbGJhY2ssIHNoaXBtZW50LmZpbmFuY2VfY2FsbGJhY2sgQVMgc2hpcG1lbnRfZmluYW5jZV9jYWxsYmFjaywgc2hpcG1lbnQuc2VsZWN0ZWRfY291cmllcl9pZCBBUyBzaGlwbWVudF9zZWxlY3RlZF9jb3VyaWVyX2lkLCBzaGlwbWVudC5jb3VyaWVyX2lkcyBBUyBzaGlwbWVudF9jb3VyaWVyX2lkcywgc2hpcG1lbnQuY2FuY2VsX3JlYXNvbiBBUyBzaGlwbWVudF9jYW5jZWxfcmVhc29uLCBzaGlwbWVudC5iaWxsaW5nX2NvZGUgQVMgc2hpcG1lbnRfYmlsbGluZ19jb2RlLCBzaGlwbWVudC5wbGF0Zm9ybV9pZCBBUyBzaGlwbWVudF9wbGF0Zm9ybV9pZCwgc2hpcG1lbnQuY3VycmVudF9jb25uZWN0b3JfY29kZSBBUyBzaGlwbWVudF9jdXJyZW50X2Nvbm5lY3Rvcl9jb2RlLCBzaGlwbWVudC5jdXJyZW50X2F3YiBBUyBzaGlwbWVudF9jdXJyZW50X2F3Yiwgc2hpcG1lbnQubGFiZWxfaW1hZ2UgQVMgc2hpcG1lbnRfbGFiZWxfaW1hZ2UsIHNoaXBtZW50Lmludm9pY2VfaW1hZ2UgQVMgc2hpcG1lbnRfaW52b2ljZV9pbWFnZSwgc2hpcG1lbnQudHJhbnNmZXJfbGFiZWxfaW1hZ2UgQVMgc2hpcG1lbnRfdHJhbnNmZXJfbGFiZWxfaW1hZ2UsIHNoaXBtZW50LnRyYW5zZmVyX2ludm9pY2VfaW1hZ2UgQVMgc2hpcG1lbnRfdHJhbnNmZXJfaW52b2ljZV9pbWFnZSwgc2hpcG1lbnQuZGVsaXZlcnlfbGFiZWxfaW1hZ2UgQVMgc2hpcG1lbnRfZGVsaXZlcnlfbGFiZWxfaW1hZ2UsIHNoaXBtZW50LnBpY2t1cF9udW1iZXIgQVMgc2hpcG1lbnRfcGlja3VwX251bWJlciwgc2hpcG1lbnQuY29ubmVjdG9yX3BpY2t1cF9zY2hlZHVsZV9pZCBBUyBzaGlwbWVudF9jb25uZWN0b3JfcGlja3VwX3NjaGVkdWxlX2lkLCBzaGlwbWVudC5hY2NvdW50X3R5cGUgQVMgc2hpcG1lbnRfYWNjb3VudF90eXBlLCBzaGlwbWVudC50ZXN0IEFTIHNoaXBtZW50X3Rlc3QsIHNoaXBtZW50LmlzX2ZpcnN0X3NoaXBtZW50IEFTIHNoaXBtZW50X2lzX2ZpcnN0X3NoaXBtZW50LCBzaGlwbWVudC52ZWhpY2xlX3R5cGVfY29kZSBBUyBzaGlwbWVudF92ZWhpY2xlX3R5cGVfY29kZSwgc2hpcG1lbnQucGlja3VwX2NvZGUgQVMgc2hpcG1lbnRfcGlja3VwX2NvZGUsIHNoaXBtZW50Lmhhc193YXliaWxsX2Vycm9yIEFTIHNoaXBtZW50X2hhc193YXliaWxsX2Vycm9yLCBzaGlwbWVudC53YXliaWxsX2Vycm9yIEFTIHNoaXBtZW50X3dheWJpbGxfZXJyb3IsIHNoaXBtZW50LmVzY2FsYXRpb25fb3BlbmVkIEFTIHNoaXBtZW50X2VzY2FsYXRpb25fb3BlbmVkLCBzaGlwbWVudC5kaXNwdXRlX29wZW5lZCBBUyBzaGlwbWVudF9kaXNwdXRlX29wZW5lZCwgc2hpcG1lbnQuc2FtZV9kYXkgQVMgc2hpcG1lbnRfc2FtZV9kYXksIHNoaXBtZW50LmZlZV9iZWZvcmVfY291cG9uIEFTIHNoaXBtZW50X2ZlZV9iZWZvcmVfY291cG9uLCBzaGlwbWVudC5jb3Vwb25fY29kZSBBUyBzaGlwbWVudF9jb3Vwb25fY29kZSwgc2hpcG1lbnQuY291cG9uX2lkIEFTIHNoaXBtZW50X2NvdXBvbl9pZCwgc2hpcG1lbnQucmVsZWFzZWRfYnlfbmFtZSBBUyBzaGlwbWVudF9yZWxlYXNlZF9ieV9uYW1lLCBzaGlwbWVudC5yZWxlYXNlZF9ieV9waG9uZSBBUyBzaGlwbWVudF9yZWxlYXNlZF9ieV9waG9uZSwgc2hpcG1lbnQucmVsZWFzZWRfYnlfc2lnbmF0dXJlIEFTIHNoaXBtZW50X3JlbGVhc2VkX2J5X3NpZ25hdHVyZSwgc2hpcG1lbnQucmVxdWlyZXNfZXNjcm93IEFTIHNoaXBtZW50X3JlcXVpcmVzX2VzY3Jvdywgc2hpcG1lbnQudGFyZ2V0IEFTIHNoaXBtZW50X3RhcmdldCwgc2hpcG1lbnQuYW1vdW50IEFTIHNoaXBtZW50X2Ftb3VudCwgc2hpcG1lbnQuY3VycmVuY3lfY29kZSBBUyBzaGlwbWVudF9jdXJyZW5jeV9jb2RlLCBzaGlwbWVudC5lc2Nyb3dfcmVmZXJlbmNlIEFTIHNoaXBtZW50X2VzY3Jvd19yZWZlcmVuY2UsIHNoaXBtZW50LmFwcGxpZWRfY3JlZGl0cyBBUyBzaGlwbWVudF9hcHBsaWVkX2NyZWRpdHMsIHNoaXBtZW50LmFwcGxpZWRfcmV3YXJkIEFTIHNoaXBtZW50X2FwcGxpZWRfcmV3YXJkLCBzaGlwbWVudC5yZXdhcmRfdmFsdWUgQVMgc2hpcG1lbnRfcmV3YXJkX3ZhbHVlLCBzaGlwbWVudC5wYWNrYWdlX2NvdXJpZXJfaWQgQVMgc2hpcG1lbnRfcGFja2FnZV9jb3VyaWVyX2lkLCBzaGlwbWVudC5wYWNrYWdlX2FnZW50X2lkIEFTIHNoaXBtZW50X3BhY2thZ2VfYWdlbnRfaWQsIHNoaXBtZW50LnBhY2thZ2VfcmVjZWl2ZWRfYnkgQVMgc2hpcG1lbnRfcGFja2FnZV9yZWNlaXZlZF9ieSwgc2hpcG1lbnQucGFja2FnZV9yZWNlaXZlZF9ieV9waG9uZSBBUyBzaGlwbWVudF9wYWNrYWdlX3JlY2VpdmVkX2J5X3Bob25lLCBzaGlwbWVudC5wYWNrYWdlX3JlY2VpdmVkX2J5X3NpZ25hdHVyZSBBUyBzaGlwbWVudF9wYWNrYWdlX3JlY2VpdmVkX2J5X3NpZ25hdHVyZSwgc2hpcG1lbnQucGFja2FnZV9kYXRlX2NyZWF0ZWQgQVMgc2hpcG1lbnRfcGFja2FnZV9kYXRlX2NyZWF0ZWQsIHNoaXBtZW50LnBhY2thZ2VfbGFzdF91cGRhdGVkIEFTIHNoaXBtZW50X3BhY2thZ2VfbGFzdF91cGRhdGVkLCBzaGlwbWVudC5wYWNrYWdlX2RhdGVfcmVjZWl2ZWQgQVMgc2hpcG1lbnRfcGFja2FnZV9kYXRlX3JlY2VpdmVkLCBzaGlwbWVudC5wYWNrYWdlX3JlamVjdGlvbl9yZWFzb24gQVMgc2hpcG1lbnRfcGFja2FnZV9yZWplY3Rpb25fcmVhc29uLCBzaGlwbWVudC5wYWNrYWdlX2RlbGl2ZXJ5X2ZlZSBBUyBzaGlwbWVudF9wYWNrYWdlX2RlbGl2ZXJ5X2ZlZSwgc2hpcG1lbnQucGFja2FnZV9kZWxpdmVyeV9zdGF0dXNfY29kZSBBUyBzaGlwbWVudF9wYWNrYWdlX2RlbGl2ZXJ5X3N0YXR1c19jb2RlLCBzaGlwbWVudC5wYWNrYWdlX2Z1bGZpbG1lbnRfc3RhdHVzX2NvZGUgQVMgc2hpcG1lbnRfcGFja2FnZV9mdWxmaWxtZW50X3N0YXR1c19jb2RlLCBzaGlwbWVudC5wYWNrYWdlX2RlbGl2ZXJ5X2RhdGUgQVMgc2hpcG1lbnRfcGFja2FnZV9kZWxpdmVyeV9kYXRlLCBzaGlwbWVudC5wYWNrYWdlX2RlbGl2ZXJ5X2V0YSBBUyBzaGlwbWVudF9wYWNrYWdlX2RlbGl2ZXJ5X2V0YSwgc2hpcG1lbnQucGFja2FnZV9kZWxpdmVyeV9hdHRlbXB0IEFTIHNoaXBtZW50X3BhY2thZ2VfZGVsaXZlcnlfYXR0ZW1wdCwgc2hpcG1lbnQucGFja2FnZV9sYWJlbF9pbWFnZSBBUyBzaGlwbWVudF9wYWNrYWdlX2xhYmVsX2ltYWdlLCBzaGlwbWVudC5wYWNrYWdlX2ludm9pY2VfaW1hZ2UgQVMgc2hpcG1lbnRfcGFja2FnZV9pbnZvaWNlX2ltYWdlLCBzaGlwbWVudC5tZXJjaGFudF9kaXJlY3Rpb24gQVMgc2hpcG1lbnRfbWVyY2hhbnRfZGlyZWN0aW9uLCBzaGlwbWVudC5kcm9wX29mZl9sb2NhdGlvbl9pZCBBUyBzaGlwbWVudF9kcm9wX29mZl9sb2NhdGlvbl9pZCwgc2hpcG1lbnQuc2VsZWN0ZWRfZHJvcF9vZmZfbG9jYXRpb25faWQgQVMgc2hpcG1lbnRfc2VsZWN0ZWRfZHJvcF9vZmZfbG9jYXRpb25faWQsIHNoaXBtZW50LmN1c3RvbWVyX2Ryb3Bfb2ZmIEFTIHNoaXBtZW50X2N1c3RvbWVyX2Ryb3Bfb2ZmLCBzaGlwbWVudC5jcmVkaXRzX3RyYW5zYWN0aW9uX2lkIEFTIHNoaXBtZW50X2NyZWRpdHNfdHJhbnNhY3Rpb25faWQsIHNoaXBtZW50Lmluc3VyYW5jZV9vcHRpb25fY29kZSBBUyBzaGlwbWVudF9pbnN1cmFuY2Vfb3B0aW9uX2NvZGUsIHNoaXBtZW50Lmluc3VyYW5jZV9mZWUgQVMgc2hpcG1lbnRfaW5zdXJhbmNlX2ZlZSwgc2hpcG1lbnQuaW5zdXJhbmNlX3ZhbHVlIEFTIHNoaXBtZW50X2luc3VyYW5jZV92YWx1ZSwgc2hpcG1lbnQuZnJhbmNoaXNlX2lkIEFTIHNoaXBtZW50X2ZyYW5jaGlzZV9pZCwgc2hpcG1lbnQucGFja2FnZV9jb25uZWN0b3JfdGFycmlmIEFTIHNoaXBtZW50X3BhY2thZ2VfY29ubmVjdG9yX3RhcnJpZiwgc2hpcG1lbnQucGFja2FnZV9jb25uZWN0b3JfZGlzY291bnQgQVMgc2hpcG1lbnRfcGFja2FnZV9jb25uZWN0b3JfZGlzY291bnQsIHNoaXBtZW50LnBhY2thZ2VfY29ubmVjdG9yX3ZhdCBBUyBzaGlwbWVudF9wYWNrYWdlX2Nvbm5lY3Rvcl92YXQsIHNoaXBtZW50LnBhY2thZ2VfY29ubmVjdG9yX2ZvcndhcmluZ19jaGFyZ2UgQVMgc2hpcG1lbnRfcGFja2FnZV9jb25uZWN0b3JfZm9yd2FyaW5nX2NoYXJnZSwgc2hpcG1lbnQucGFja2FnZV9jb25uZWN0b3JfYW1vdW50X2R1ZSBBUyBzaGlwbWVudF9wYWNrYWdlX2Nvbm5lY3Rvcl9hbW91bnRfZHVlLCBzaGlwbWVudC5wYWNrYWdlX2Nvbm5lY3Rvcl93ZWlnaHQgQVMgc2hpcG1lbnRfcGFja2FnZV9jb25uZWN0b3Jfd2VpZ2h0LCBzaGlwbWVudC5wYWNrYWdlX2Nvbm5lY3Rvcl9kaW1lbnNpb25fd2VpZ2h0IEFTIHNoaXBtZW50X3BhY2thZ2VfY29ubmVjdG9yX2RpbWVuc2lvbl93ZWlnaHQsIHNoaXBtZW50LnBhY2thZ2VfY29ubmVjdG9yX2JpbGxhYmxlX3dlaWdodCBBUyBzaGlwbWVudF9wYWNrYWdlX2Nvbm5lY3Rvcl9iaWxsYWJsZV93ZWlnaHQsIHNoaXBtZW50LnBhY2thZ2VfY29ubmVjdG9yX290aGVyX2NoYXJnZSBBUyBzaGlwbWVudF9wYWNrYWdlX2Nvbm5lY3Rvcl9vdGhlcl9jaGFyZ2UsIHNoaXBtZW50LnBhY2thZ2VfY29ubmVjdG9yX290aGVyX2NoYXJnZV9yZWFzb24gQVMgc2hpcG1lbnRfcGFja2FnZV9jb25uZWN0b3Jfb3RoZXJfY2hhcmdlX3JlYXNvbiwgc2hpcG1lbnQubGFzdF91cGRhdGVkIEFTIHNoaXBtZW50X2xhc3RfdXBkYXRlZCwgc2hpcG1lbnQuZGF0ZV9jcmVhdGVkIEFTIHNoaXBtZW50X2RhdGVfY3JlYXRlZCAKRlJPTSBzaGlwbWVudCAKV0hFUkUgc2hpcG1lbnQudGVzdCAhPSB0cnVlIEFORCBzaGlwbWVudC5zdGF0dXNfY29kZSBJTiAoJShzdGF0dXNfY29kZV8xKXMsICUoc3RhdHVzX2NvZGVfMilzLCAlKHN0YXR1c19jb2RlXzMpcykgQU5EIHNoaXBtZW50Lm1lcmNoYW50X2lkID0gJShtZXJjaGFudF9pZF8xKXMgT1JERVIgQlkgc2hpcG1lbnQuZGF0ZV9jcmVhdGVkIERFU0M=",
"results": [
{
"destination_contact_phone": "08012345678",
"code": "0006320484",
"status_code": "drafted",
"height": 0,
"time_schedule": {
"code": "anytime",
"name": "Anytime"
},
"amount": null,
"is_spillable": false,
"narration": null,
"owner": "Sendbox",
"destination_address": "20 Oregun Ikeja Ikeja Lagos Nigeria",
"destination_name": "Johnny English",
"incoming_option": {
"code": "pickup",
"name": "Pickup"
},
"payment_options": null,
"origin_city": "Lagos",
"width": 0,
"package_delivery_attempt": 0,
"short_origin_address": "Lagos Lagos Nigeria",
"origin_phone": "0801234567890",
"package_received_by": null,
"destination_city": "Ikeja",
"package_delivery_status_code": null,
"recurrent_cards": [],
"package_label_image": null,
"origin_state": {
"code": "LOS",
"name": "Lagos"
},
"has_waybill_error": false,
"insurance_option_code": null,
"pk": "894688",
"package_invoice_image": null,
"transaction_id": null,
"merchant": {
"username": null,
"email": "[email protected]",
"id": 10383,
"phone": "081234567890",
"name": "John"
},
"delivery_priority": {
"code": "next_day",
"name": "Next Day"
},
"payment_option": {
"code": null,
"name": null
},
"courier": {
"name": "Sixth Gear Logistics"
},
"total_value": 90,
"package_fulfilment_status_code": null,
"origin_address": "20 Old Yaba Road Lagos Lagos Lagos Nigeria",
"package_agent": {
"username": null,
"email": null,
"id": 0,
"phone": null,
"name": null
},
"min_quoted_fee": 1015,
"pickup_attempts": [],
"origin_state_code": "LOS",
"package_type_code": null,
"max_quoted_fee": 1015,
"tracking": {
"destination_country": null,
"status": null,
"origin_city": null,
"destination_city": null,
"origin_name": null,
"destination_name": null,
"current_awb": null,
"origin_country": null
},
"client_id": 0,
"destination_email": "[email protected]",
"origin_contact_phone": "080123456789",
"package_delivery_fee": 0,
"origin_post_code": null,
"coupon_description": null,
"possible_actions": [
{
"code": "pay",
"name": "Pay"
},
{
"code": "cancel",
"name": "Cancel"
}
],
"notes": null,
"current_status": {
"code": "drafted",
"name": "On Hold"
},
"use_selected_rate": null,
"destination_street": "20 Oregun Ikeja",
"package_delivery_date": null,
"reference_code": "74",
"selected_rate_id": null,
"pod": "Prepaid",
"destination_state": {
"code": "LOS",
"name": "Lagos"
},
"shipment_id": null,
"origin_city_id": 1175,
"domain": null,
"package_type": {
"code": null,
"name": null
},
"last_updated": "2019-11-15T14:41:06.185519",
"weight": 0,
"amount_to_receive": 1263.72,
"destination_state_code": "LOS",
"sensitivity": "",
"package_fulfilment_status": {
"code": null,
"name": null
},
"package_delivery_eta": null,
"origin_country": {
"code": "NG",
"name": "Nigeria"
},
"package_courier_id": null,
"delivery_priority_code": "next_day",
"origin_country_code": "NG",
"package_agent_id": 0,
"package_date_received": null,
"package_delivery_status": {
"code": null,
"name": null
},
"has_waybill": null,
"delivery_type_code": "last_mile",
"short_destination_address": "Ikeja Lagos Nigeria",
"pickup_courier": {
"status": null,
"courier_name": null
},HP
Posting data is a little different from fetching data. here you are required to make a post request to the endpoint and pass in a body of JSON data you would like to post. For example, let's say you want to get delivery quotes for a shipment. You simply make a post request to the delivery quotes endpoint this returns a status code 201 and quotes of that shipments in JSON format.
JSON body sample to make a post request
{
"origin_country":"Nigeria",
"origin_country_code":"NG",
"origin_state" : "Lagos",
"destination_country":"Nigeria",
"destination_country_code":" ",
"destination_state": "Abuja",
"weight" : 3,
"destination_state_code":"ABV",
"origin_state_code": "LOS"
}
https://live.sendbox.co/shipping/shipment_delivery_quoteIn this example, we are making a post request to the shipment_delivery_quote endpoint.
Request
Response
Name | Type | Description |
Authorization | String | Authorization-key |
Content-type | String | application/json |
Name | Type | Description |
origin_country | String | senders country |
origin_country_code | String | senders country code |
origin_state | String | senders state |
origin_state_code | String | senders state code |
destination_country | String | recipient country |
destination_country_code | String | recipient country code |
destination_state | String | recipient state |
destination_state_code | String | recipient state code |
weight | float | weight of package |
201: Created
{
"credit_amount": null,
"payment_option": {
"code": null,
"name": null
},
"weight": 8.1,
"total_value": 0,
"destination_state_code": "LOS",
"min_quoted_fee": 1000,
"origin_state_code": "LOS",
"time_schedule_code": "anytime",
"incoming_option_code": "pickup",
"max_quoted_fee": 8783.775,
"delivery_priority_code": "next_day",
"accept_value_on_delivery": null,
"selected_rate": {
"discount": null,
"courier_id": 0,
"fee": null,
"name": null,
"courier": {
"name": null
},
"return_fee": null,
"actual_fee": null,
"fee_with_return": null,
"id": null
},
"origin_country_code": "NG",
"payment_options": [
{
"pk": "book_on_hold",
"brand": "wallet",
"code": "book_on_hold",
"mask": "Book on hold",
"friendly_brand": "You will be debited from your wallet"
}
],
"origin_city": "Ketu",
"total_quantity": 0,
"delivery_type_code": "last_mile",
"payment_option_code": null,
"destination_city": "zone 5",
"destination_country_code": "NG",
"recurrent_cards": [
{
"pk": "book_on_hold",
"brand": "wallet",
"mask": "Book on hold",
"id": null,
"friendly_brand": "You will be debited from your wallet"
}
],
"rates": [
{
"discount": null,
"courier_id": 3,
"fee": 1000,
"name": "Sixth Gear Logistics",
"courier": {
"name": "Sixth Gear Logistics"
},
"return_fee": 50,
"actual_fee": null,
"fee_with_return": 1050,
"id": "3_1000.0"
},
{
"discount": null,
"courier_id": 19,
"fee": 2200,
"name": "Parcel Line Logistics",
"courier": {
"name": "Parcel Line Logistics"
},
"return_fee": 50,
"actual_fee": null,
"fee_with_return": 2250,
"id": "19_2200.0"
},
{
"discount": null,
"courier_id": 20,
"fee": 1800,
"name": "CRS Logistics",
"courier": {
"name": "CRS Logistics"
},
"return_fee": 50,
"actual_fee": null,
"fee_with_return": 1850,
"id": "20_1800.0"
},
{
"discount": null,
"courier_id": 22,
"fee": 8783.775,
"name": "DHL",
"courier": {
"name": "DHL"
},
"return_fee": 0,
"actual_fee": null,
"fee_with_return": null,
"id": "22"
}
],
"selected_rate_id": null,
"use_selected_rate": null,
"vat": null
}
Last modified 2yr ago