Deliveries API
Search…
Introduction
General
Introduction
Authentication
Quotes
Deliveries
Statuses
Webhooks
Interactive Delivery Tracking
Integrations
Overview
Entities to know
Entities
Upcoming
The new stuff
Powered By GitBook
Quotes
Quotes are shipping options with different prices depending on the promise of time to deliver. Prices may differ depending on the area/city .
You can choose from 3 types of Quotes that depend on each city. If you are a company with less than 100 deliveries a day, you are most likely to use these available fares to create a delivery in our system.
Note: There are fares previously arranged with certain companies that will be generated automatically when a delivery is created using this endpoint . Learn more about contracts and covenants with companies that have specific operation rules and volume contacting to our team at http://shippify.co

Types of Quotes

There are 3 types of Quotations you can choose that will have different prices, pickup and delivery scheduled times.
  • Express (Deliver under 3 hours)
  • Scheduled time slots (Time windows during the day)
  • Flex (Collect in the morning, deliver in the afternoon)
If you want to see how this is currently working you can login in our dashboard and follow the steps here.
This is a UI example of how we use QUOTES to show to every user in our system. You can do your own implementation in your e-commerce or mobile commerce.
Could not load image

Request Quotes

List the quotes available for a given delivery(or set of deliveries).
POST /deliveries/quotes
date => If you'd like to set the pickup time when the delivery has to get started. (UNIXTIMESTAMP in ms)(Optional)
deliveries => List of deliveries
express => false if you want to avoid listing express quotes.(Default: true, Optional)
flexible => true if you want to list flexible quote times, for same day delivery (Default: false, Optional)
limit => Maximum number of quotes to be returned (Optional, integer)
timeslots => false if you want to avoid listing express with time slots, for same day delivery. (Default: true, Optional)
curl
JavaScript
curl -X POST \
https://api.shippify.co/v1/deliveries/quotes/ \
-H 'authorization: Basic XXXXXXXXXXXXXXXXXXXXXXXXXXX' \
-H 'content-type: application/json' \
-d '{
"deliveries": [
{
"pickup": {
"contact": {
"name": "John Doe",
"email": "[email protected]",
"phonenumber": "+19209489292"
},
"location": {
"address": "Central Park, New York, NY, United States",
"instructions": "Central Park West, APT 10920"
}
},
"dropoff":{
"contact": {
"name": "Mary Doe",
"email": "[email protected]",
"phonenumber": "+19209085222"
},
"location": {
"address": "200 Eastern Pkwy, Brooklyn, NY 11238, USA",
"instructions": "APT 2094",
"lat": 40.6720036,
"lng": -73.9593279
}
},
"packages": [
{
"name": "paperwork1",
"size": "xs",
"qty": 1
}
]
}
​
]
}'
var data = JSON.stringify({
"deliveries": [
{
"pickup": {
"contact": {
"name": "John Doe",
"email": "[email protected]",
"phonenumber": "+19209489292"
},
"location": {
"address": "Central Park, New York, NY, United States",
"instructions": "Central Park West, APT 10920"
},
"date": 1578787200000
},
"dropoff": {
"contact": {
"name": "Mary Doe",
"email": "[email protected]",
"phonenumber": "+19209085222"
},
"location": {
"address": "200 Eastern Pkwy, Brooklyn, NY 11238, USA",
"instructions": "APT 2094",
"lat": 40.6720036,
"lng": -73.9593279
}
},
"packages": [
{
"name": "paperwork1",
"size": "xs",
"qty": 1
}
]
}
]
});
​
var xhr = new XMLHttpRequest();
xhr.withCredentials = true;
​
xhr.addEventListener("readystatechange", function () {
if (this.readyState === 4) {
console.log(this.responseText);
}
});
​
xhr.open("POST", "https://api.shippify.co/v1/deliveries/quotes/");
xhr.setRequestHeader("authorization", "Basic XXXXXXXXXXXXXXXXXXXXXXX");
xhr.setRequestHeader("content-type", "application/json");
​
xhr.send(data);

Responses

After a Quote is retrieved, the following payload is received and you can use the `quoteId` in order to create a delivery .
200|Success
curl
JavaScript
{
message: "quotes created successfully",
payload: {
"slots": [
{
"quoteId": 136498,
"city": 2,
"pickup": [
{
"contact": {
"name": "Wander b",
"email": "[email protected]"
},
"location": {
"instructions": "Av. Francisco de Orellana, Guayaquil 090512",
"address": "Av. Francisco de Orellana, Guayaquil, Ecuador",
"lat": -2.1629639,
"lng": -79.89776359999999
}
}
],
"dropoff": [
{
"contact": {
"name": "Andres b",
"email": "[email protected]"
},
"location": {
"instructions": "Sauces 9, Guayaquil",
"address": "Sauces 9, Guayaquil 090505, Ecuador",
"lat": -2.1323186,
"lng": -79.8926809
}
}
],
"cost": 3.26,
"currencyCode": "USD",
"currency": "USD",
"pickupStartTime": 1518267600000,
"pickupEndTime": 1518271200000,
"dropoffStartTime": 1518271200000,
"dropoffEndTime": 1518274800000,
"expiration": 30,
"pickupMaxAvailableTime": 1518274800000,
"isFlexible": false,
"companyId": "654",
"size": [
"3"
],
"distance": [
"5.1"
],
"subtotal": [
"3.26"
]
},
​
{
"quoteId": 136507,
"city": 2,
"pickup": [
{
"contact": {
"name": "Wander b",
"email": "[email protected]"
},
"location": {
"instructions": "Av. Francisco de Orellana, Guayaquil 090512",
"address": "Av. Francisco de Orellana, Guayaquil, Ecuador",
"lat": -2.1629639,
"lng": -79.89776359999999
}
}
],
"dropoff": [
{
"contact": {
"name": "Andres b",
"email": "[email protected]"
},
"location": {
"instructions": "Sauces 9, Guayaquil",
"address": "Sauces 9, Guayaquil 090505, Ecuador",
"lat": -2.1323186,
"lng": -79.8926809
}
}
],
"cost": 3.26,
"currencyCode": "USD",
"currency": "USD",
"pickupStartTime": 1518300000000,
"pickupEndTime": 1518303600000,
"dropoffStartTime": 1518303600000,
"dropoffEndTime": 1518307200000,
"expiration": 30,
"pickupMaxAvailableTime": 1518307200000,
"isFlexible": false,
"companyId": "654",
"size": [
"3"
],
"distance": [
"5.1"
],
"subtotal": [
"3.26"
]
},
{
"quoteId": 136508,
"city": 2,
"pickup": [
{
"contact": {
"name": "Wander b",
"email": "[email protected]"
},
"location": {
"instructions": "Av. Francisco de Orellana, Guayaquil 090512",
"address": "Av. Francisco de Orellana, Guayaquil, Ecuador",
"lat": -2.1629639,
"lng": -79.89776359999999
}
}
],
"dropoff": [
{
"contact": {
"name": "Andres b",
"email": "[email protected]"
},
"location": {
"instructions": "Sauces 9, Guayaquil",
"address": "Sauces 9, Guayaquil 090505, Ecuador",
"lat": -2.1323186,
"lng": -79.8926809
}
}
],
"cost": 3.26,
"currencyCode": "USD",
"currency": "USD",
"pickupStartTime": 1518303600000,
"pickupEndTime": 1518307200000,
"dropoffStartTime": 1518307200000,
"dropoffEndTime": 1518310800000,
"expiration": 30,
"pickupMaxAvailableTime": 1518310800000,
"isFlexible": false,
"companyId": "654",
"size": [
"3"
],
"distance": [
"5.1"
],
"subtotal": [
"3.26"
]
},
{
"quoteId": 136509,
"city": 2,
"pickup": [
{
"contact": {
"name": "Wander b",
"email": "[email protected]"
},
"location": {
"instructions": "Av. Francisco de Orellana, Guayaquil 090512",
"address": "Av. Francisco de Orellana, Guayaquil, Ecuador",
"lat": -2.1629639,
"lng": -79.89776359999999
}
}
],
"dropoff": [
{
"contact": {
"name": "Andres b",
"email": "[email protected]"
},
"location": {
"instructions": "Sauces 9, Guayaquil",
"address": "Sauces 9, Guayaquil 090505, Ecuador",
"lat": -2.1323186,
"lng": -79.8926809
}
}
],
"cost": 3.26,
"currencyCode": "USD",
"currency": "USD",
"pickupStartTime": 1518307200000,
"pickupEndTime": 1518310800000,
"dropoffStartTime": 1518310800000,
"dropoffEndTime": 1518314400000,
"expiration": 30,
"pickupMaxAvailableTime": 1518314400000,
"isFlexible": false,
"companyId": "654",
"size": [
"3"
],
"distance": [
"5.1"
],
"subtotal": [
"3.26"
]
},
{
"quoteId": 136510,
"city": 2,
"pickup": [
{
"contact": {
"name": "Wander b",
"email": "[email protected]"
},
"location": {
"instructions": "Av. Francisco de Orellana, Guayaquil 090512",
"address": "Av. Francisco de Orellana, Guayaquil, Ecuador",
"lat": -2.1629639,
"lng": -79.89776359999999
}
}
],
"dropoff": [
{
"contact": {
"name": "Andres b",
"email": "[email protected]"
},
"location": {
"instructions": "Sauces 9, Guayaquil",
"address": "Sauces 9, Guayaquil 090505, Ecuador",
"lat": -2.1323186,
"lng": -79.8926809
}
}
],
"cost": 3.26,
"currencyCode": "USD",
"currency": "USD",
"pickupStartTime": 1518310800000,
"pickupEndTime": 1518314400000,
"dropoffStartTime": 1518314400000,
"dropoffEndTime": 1518318000000,
"expiration": 30,
"pickupMaxAvailableTime": 1518318000000,
"isFlexible": false,
"companyId": "654",
"size": [
"3"
],
"distance": [
"5.1"
],
"subtotal": [
"3.26"
]
}
],
"express": {
"quoteId": 136514,
"city": 2,
"pickup": [
{
"contact": {
"name": "Wander b",
"email": "[email protected]"
},
"location": {
"instructions": "Av. Francisco de Orellana, Guayaquil 090512",
"address": "Av. Francisco de Orellana, Guayaquil, Ecuador",
"lat": -2.1629639,
"lng": -79.89776359999999
}
}
],
"dropoff": [
{
"contact": {
"name": "Andres b",
"email": "[email protected]"
},
"location": {
"instructions": "Sauces 9, Guayaquil",
"address": "Sauces 9, Guayaquil 090505, Ecuador",
"lat": -2.1323186,
"lng": -79.8926809
}
}
],
"cost": 3.26,
"currencyCode": "USD",
"currency": "USD",
"pickupStartTime": 1518304378591,
"pickupEndTime": 1518306178591,
"dropoffStartTime": 1518306178591,
"dropoffEndTime": 1518307978591,
"expiration": 30,
"pickupMaxAvailableTime": 1518307978591,
"isFlexible": false,
"companyId": "654",
"size": [
"3"
],
"distance": [
"5.1"
],
"subtotal": [
"3.26"
]
},
"flex": {
"quoteId": 136497,
"city": 2,
"pickup": [
{
"contact": {
"name": "Wander b",
"email": "[email protected]"
},
"location": {
"instructions": "Av. Francisco de Orellana, Guayaquil 090512",
"address": "Av. Francisco de Orellana, Guayaquil, Ecuador",
"lat": -2.1629639,
"lng": -79.89776359999999
}
}
],
"dropoff": [
{
"contact": {
"name": "Andres b",
"email": "[email protected]"
},
"location": {
"instructions": "Sauces 9, Guayaquil",
"address": "Sauces 9, Guayaquil 090505, Ecuador",
"lat": -2.1323186,
"lng": -79.8926809
}
}
],
"cost": 3.26,
"currencyCode": "USD",
"currency": "USD",
"pickupStartTime": 1518008400000,
"pickupEndTime": 1518026400000,
"dropoffStartTime": 1518026400000,
"dropoffEndTime": 1518044400000,
"expiration": 30,
"pickupMaxAvailableTime": 1518030000000,
"isFlexible": true,
"companyId": "654",
"size": [
"3"
],
"distance": [
"5.1"
],
"subtotal": [
"3.26"
]
},
"steps": {}
}
}
{
message: "quotes created successfully",
payload: {
"slots": [
{
"quoteId": 136498,
"city": 2,
"pickup": [
{
"contact": {
"name": "Wander b",
"email": "[email protected]"
},
"location": {
"instructions": "Av. Francisco de Orellana, Guayaquil 090512",
"address": "Av. Francisco de Orellana, Guayaquil, Ecuador",
"lat": -2.1629639,
"lng": -79.89776359999999
}
}
],
"dropoff": [
{
"contact": {
"name": "Andres b",
"email": "[email protected]"
},
"location": {
"instructions": "Sauces 9, Guayaquil",
"address": "Sauces 9, Guayaquil 090505, Ecuador",
"lat": -2.1323186,
"lng": -79.8926809
}
}
],
"cost": 3.26,
"currencyCode": "USD",
"currency": "USD",
"pickupStartTime": 1518267600000,
"pickupEndTime": 1518271200000,
"dropoffStartTime": 1518271200000,
"dropoffEndTime": 1518274800000,
"expiration": 30,
"pickupMaxAvailableTime": 1518274800000,
"isFlexible": false,
"companyId": "654",
"size": [
"3"
],
"distance": [
"5.1"
],
"subtotal": [
"3.26"
]
},
​
{
"quoteId": 136507,
"city": 2,
"pickup": [
{
"contact": {
"name": "Wander b",
"email": "[email protected]"
},
"location": {
"instructions": "Av. Francisco de Orellana, Guayaquil 090512",
"address": "Av. Francisco de Orellana, Guayaquil, Ecuador",
"lat": -2.1629639,
"lng": -79.89776359999999
}
}
],
"dropoff": [
{
"contact": {
"name": "Andres b",
"email": "[email protected]"
},
"location": {
"instructions": "Sauces 9, Guayaquil",
"address": "Sauces 9, Guayaquil 090505, Ecuador",
"lat": -2.1323186,
"lng": -79.8926809
}
}
],
"cost": 3.26,
"currencyCode": "USD",
"currency": "USD",
"pickupStartTime": 1518300000000,
"pickupEndTime": 1518303600000,
"dropoffStartTime": 1518303600000,
"dropoffEndTime": 1518307200000,
"expiration": 30,
"pickupMaxAvailableTime": 1518307200000,
"isFlexible": false,
"companyId": "654",
"size": [
"3"
],
"distance": [
"5.1"
],
"subtotal": [
"3.26"
]
},
{
"quoteId": 136508,
"city": 2,
"pickup": [
{
"contact": {
"name": "Wander b",
"email": "[email protected]"
},
"location": {
"instructions": "Av. Francisco de Orellana, Guayaquil 090512",
"address": "Av. Francisco de Orellana, Guayaquil, Ecuador",
"lat": -2.1629639,
"lng": -79.89776359999999
}
}
],
"dropoff": [
{
"contact": {
"name": "Andres b",
"email": "[email protected]"
},
"location": {
"instructions": "Sauces 9, Guayaquil",
"address": "Sauces 9, Guayaquil 090505, Ecuador",
"lat": -2.1323186,
"lng": -79.8926809
}
}
],
"cost": 3.26,
"currencyCode": "USD",
"currency": "USD",
"pickupStartTime": 1518303600000,
"pickupEndTime": 1518307200000,
"dropoffStartTime": 1518307200000,
"dropoffEndTime": 1518310800000,
"expiration": 30,
"pickupMaxAvailableTime": 1518310800000,
"isFlexible": false,
"companyId": "654",
"size": [
"3"
],
"distance": [
"5.1"
],
"subtotal": [
"3.26"
]
},
{
"quoteId": 136509,
"city": 2,
"pickup": [
{
"contact": {
"name": "Wander b",
"email": "[email protected]"
},
"location": {
"instructions": "Av. Francisco de Orellana, Guayaquil 090512",
"address": "Av. Francisco de Orellana, Guayaquil, Ecuador",
"lat": -2.1629639,
"lng": -79.89776359999999
}
}
],
"dropoff": [
{
"contact": {
"name": "Andres b",
"email": "[email protected]"
},
"location": {
"instructions": "Sauces 9, Guayaquil",
"address": "Sauces 9, Guayaquil 090505, Ecuador",
"lat": -2.1323186,
"lng": -79.8926809
}
}
],
"cost": 3.26,
"currencyCode": "USD",
"currency": "USD",
"pickupStartTime": 1518307200000,
"pickupEndTime": 1518310800000,
"dropoffStartTime": 1518310800000,
"dropoffEndTime": 1518314400000,
"expiration": 30,
"pickupMaxAvailableTime": 1518314400000,
"isFlexible": false,
"companyId": "654",
"size": [
"3"
],
"distance": [
"5.1"
],
"subtotal": [
"3.26"
]
},
{
"quoteId": 136510,
"city": 2,
"pickup": [
{
"contact": {
"name": "Wander b",
"email": "[email protected]"
},
"location": {
"instructions": "Av. Francisco de Orellana, Guayaquil 090512",
"address": "Av. Francisco de Orellana, Guayaquil, Ecuador",
"lat": -2.1629639,
"lng": -79.89776359999999
}
}
],
"dropoff": [
{
"contact": {
"name": "Andres b",
"email": "[email protected]"
},
"location": {
"instructions": "Sauces 9, Guayaquil",
"address": "Sauces 9, Guayaquil 090505, Ecuador",
"lat": -2.1323186,
"lng": -79.8926809
}
}
],
"cost": 3.26,
"currencyCode": "USD",
"currency": "USD",
"pickupStartTime": 1518310800000,
"pickupEndTime": 1518314400000,
"dropoffStartTime": 1518314400000,
"dropoffEndTime": 1518318000000,
"expiration": 30,
"pickupMaxAvailableTime": 1518318000000,
"isFlexible": false,
"companyId": "654",
"size": [
"3"
],
"distance": [
"5.1"
],
"subtotal": [
"3.26"
]
}
],
"express": {
"quoteId": 136514,
"city": 2,
"pickup": [
{
"contact": {
"name": "Wander b",
"email": "[email protected]"
},
"location": {
"instructions": "Av. Francisco de Orellana, Guayaquil 090512",
"address": "Av. Francisco de Orellana, Guayaquil, Ecuador",
"lat": -2.1629639,
"lng": -79.89776359999999
}
}
],
"dropoff": [
{
"contact": {
"name": "Andres b",
"email": "[email protected]"
},
"location": {
"instructions": "Sauces 9, Guayaquil",
"address": "Sauces 9, Guayaquil 090505, Ecuador",
"lat": -2.1323186,
"lng": -79.8926809
}
}
],
"cost": 3.26,
"currencyCode": "USD",
"currency": "USD",
"pickupStartTime": 1518304378591,
"pickupEndTime": 1518306178591,
"dropoffStartTime": 1518306178591,
"dropoffEndTime": 1518307978591,
"expiration": 30,
"pickupMaxAvailableTime": 1518307978591,
"isFlexible": false,
"companyId": "654",
"size": [
"3"
],
"distance": [
"5.1"
],
"subtotal": [
"3.26"
]
},
"flex": {
"quoteId": 136497,
"city": 2,
"pickup": [
{
"contact": {
"name": "Wander b",
"email": "[email protected]"
},
"location": {
"instructions": "Av. Francisco de Orellana, Guayaquil 090512",
"address": "Av. Francisco de Orellana, Guayaquil, Ecuador",
"lat": -2.1629639,
"lng": -79.89776359999999
}
}
],
"dropoff": [
{
"contact": {
"name": "Andres b",
"email": "[email protected]"
},
"location": {
"instructions": "Sauces 9, Guayaquil",
"address": "Sauces 9, Guayaquil 090505, Ecuador",
"lat": -2.1323186,
"lng": -79.8926809
}
}
],
"cost": 3.26,
"currencyCode": "USD",
"currency": "USD",
"pickupStartTime": 1518008400000,
"pickupEndTime": 1518026400000,
"dropoffStartTime": 1518026400000,
"dropoffEndTime": 1518044400000,
"expiration": 30,
"pickupMaxAvailableTime": 1518030000000,
"isFlexible": true,
"companyId": "654",
"size": [
"3"
],
"distance": [
"5.1"
],
"subtotal": [
"3.26"
]
},
"steps": {}
}
}
400|Bad Request
curl
JavaScript
{
message: "Bad Request",
payload: { }
}
{
message: "Bad Request",
payload: { }
}
500|Internal Server error
curl
JavaScript
{
message: "Error while retrieving the quote",
payload: { }
}
{
message: "Error while retrieving the quote",
payload: { }
}
General - Previous
Authentication
Next - General
Deliveries
Last modified 2yr ago
Copy link
Outline
Types of Quotes
Request Quotes
Responses