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).
1
POST /deliveries/quotes
Copied!
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
1
curl -X POST \
2
https://api.shippify.co/v1/deliveries/quotes/ \
3
-H 'authorization: Basic XXXXXXXXXXXXXXXXXXXXXXXXXXX' \
4
-H 'content-type: application/json' \
5
-d '{
6
"deliveries": [
7
{
8
"pickup": {
9
"contact": {
10
"name": "John Doe",
11
"email": "[email protected]",
12
"phonenumber": "+19209489292"
13
},
14
"location": {
15
"address": "Central Park, New York, NY, United States",
16
"instructions": "Central Park West, APT 10920"
17
}
18
},
19
"dropoff":{
20
"contact": {
21
"name": "Mary Doe",
22
"email": "[email protected]",
23
"phonenumber": "+19209085222"
24
},
25
"location": {
26
"address": "200 Eastern Pkwy, Brooklyn, NY 11238, USA",
27
"instructions": "APT 2094",
28
"lat": 40.6720036,
29
"lng": -73.9593279
30
}
31
},
32
"packages": [
33
{
34
"name": "paperwork1",
35
"size": "xs",
36
"qty": 1
37
}
38
]
39
}
40
41
]
42
}'
Copied!
1
var data = JSON.stringify({
2
"deliveries": [
3
{
4
"pickup": {
5
"contact": {
6
"name": "John Doe",
7
"email": "[email protected]",
8
"phonenumber": "+19209489292"
9
},
10
"location": {
11
"address": "Central Park, New York, NY, United States",
12
"instructions": "Central Park West, APT 10920"
13
},
14
"date": 1578787200000
15
},
16
"dropoff": {
17
"contact": {
18
"name": "Mary Doe",
19
"email": "[email protected]",
20
"phonenumber": "+19209085222"
21
},
22
"location": {
23
"address": "200 Eastern Pkwy, Brooklyn, NY 11238, USA",
24
"instructions": "APT 2094",
25
"lat": 40.6720036,
26
"lng": -73.9593279
27
}
28
},
29
"packages": [
30
{
31
"name": "paperwork1",
32
"size": "xs",
33
"qty": 1
34
}
35
]
36
}
37
]
38
});
39
40
var xhr = new XMLHttpRequest();
41
xhr.withCredentials = true;
42
43
xhr.addEventListener("readystatechange", function () {
44
if (this.readyState === 4) {
45
console.log(this.responseText);
46
}
47
});
48
49
xhr.open("POST", "https://api.shippify.co/v1/deliveries/quotes/");
50
xhr.setRequestHeader("authorization", "Basic XXXXXXXXXXXXXXXXXXXXXXX");
51
xhr.setRequestHeader("content-type", "application/json");
52
53
xhr.send(data);
Copied!

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
1
{
2
message: "quotes created successfully",
3
payload: {
4
"slots": [
5
{
6
"quoteId": 136498,
7
"city": 2,
8
"pickup": [
9
{
10
"contact": {
11
"name": "Wander b",
12
"email": "[email protected]"
13
},
14
"location": {
15
"instructions": "Av. Francisco de Orellana, Guayaquil 090512",
16
"address": "Av. Francisco de Orellana, Guayaquil, Ecuador",
17
"lat": -2.1629639,
18
"lng": -79.89776359999999
19
}
20
}
21
],
22
"dropoff": [
23
{
24
"contact": {
25
"name": "Andres b",
26
"email": "[email protected]"
27
},
28
"location": {
29
"instructions": "Sauces 9, Guayaquil",
30
"address": "Sauces 9, Guayaquil 090505, Ecuador",
31
"lat": -2.1323186,
32
"lng": -79.8926809
33
}
34
}
35
],
36
"cost": 3.26,
37
"currencyCode": "USD",
38
"currency": "USD",
39
"pickupStartTime": 1518267600000,
40
"pickupEndTime": 1518271200000,
41
"dropoffStartTime": 1518271200000,
42
"dropoffEndTime": 1518274800000,
43
"expiration": 30,
44
"pickupMaxAvailableTime": 1518274800000,
45
"isFlexible": false,
46
"companyId": "654",
47
"size": [
48
"3"
49
],
50
"distance": [
51
"5.1"
52
],
53
"subtotal": [
54
"3.26"
55
]
56
},
57
58
{
59
"quoteId": 136507,
60
"city": 2,
61
"pickup": [
62
{
63
"contact": {
64
"name": "Wander b",
65
"email": "[email protected]"
66
},
67
"location": {
68
"instructions": "Av. Francisco de Orellana, Guayaquil 090512",
69
"address": "Av. Francisco de Orellana, Guayaquil, Ecuador",
70
"lat": -2.1629639,
71
"lng": -79.89776359999999
72
}
73
}
74
],
75
"dropoff": [
76
{
77
"contact": {
78
"name": "Andres b",
79
"email": "[email protected]"
80
},
81
"location": {
82
"instructions": "Sauces 9, Guayaquil",
83
"address": "Sauces 9, Guayaquil 090505, Ecuador",
84
"lat": -2.1323186,
85
"lng": -79.8926809
86
}
87
}
88
],
89
"cost": 3.26,
90
"currencyCode": "USD",
91
"currency": "USD",
92
"pickupStartTime": 1518300000000,
93
"pickupEndTime": 1518303600000,
94
"dropoffStartTime": 1518303600000,
95
"dropoffEndTime": 1518307200000,
96
"expiration": 30,
97
"pickupMaxAvailableTime": 1518307200000,
98
"isFlexible": false,
99
"companyId": "654",
100
"size": [
101
"3"
102
],
103
"distance": [
104
"5.1"
105
],
106
"subtotal": [
107
"3.26"
108
]
109
},
110
{
111
"quoteId": 136508,
112
"city": 2,
113
"pickup": [
114
{
115
"contact": {
116
"name": "Wander b",
117
"email": "[email protected]"
118
},
119
"location": {
120
"instructions": "Av. Francisco de Orellana, Guayaquil 090512",
121
"address": "Av. Francisco de Orellana, Guayaquil, Ecuador",
122
"lat": -2.1629639,
123
"lng": -79.89776359999999
124
}
125
}
126
],
127
"dropoff": [
128
{
129
"contact": {
130
"name": "Andres b",
131
"email": "[email protected]"
132
},
133
"location": {
134
"instructions": "Sauces 9, Guayaquil",
135
"address": "Sauces 9, Guayaquil 090505, Ecuador",
136
"lat": -2.1323186,
137
"lng": -79.8926809
138
}
139
}
140
],
141
"cost": 3.26,
142
"currencyCode": "USD",
143
"currency": "USD",
144
"pickupStartTime": 1518303600000,
145
"pickupEndTime": 1518307200000,
146
"dropoffStartTime": 1518307200000,
147
"dropoffEndTime": 1518310800000,
148
"expiration": 30,
149
"pickupMaxAvailableTime": 1518310800000,
150
"isFlexible": false,
151
"companyId": "654",
152
"size": [
153
"3"
154
],
155
"distance": [
156
"5.1"
157
],
158
"subtotal": [
159
"3.26"
160
]
161
},
162
{
163
"quoteId": 136509,
164
"city": 2,
165
"pickup": [
166
{
167
"contact": {
168
"name": "Wander b",
169
"email": "[email protected]"
170
},
171
"location": {
172
"instructions": "Av. Francisco de Orellana, Guayaquil 090512",
173
"address": "Av. Francisco de Orellana, Guayaquil, Ecuador",
174
"lat": -2.1629639,
175
"lng": -79.89776359999999
176
}
177
}
178
],
179
"dropoff": [
180
{
181
"contact": {
182
"name": "Andres b",
183
"email": "[email protected]"
184
},
185
"location": {
186
"instructions": "Sauces 9, Guayaquil",
187
"address": "Sauces 9, Guayaquil 090505, Ecuador",
188
"lat": -2.1323186,
189
"lng": -79.8926809
190
}
191
}
192
],
193
"cost": 3.26,
194
"currencyCode": "USD",
195
"currency": "USD",
196
"pickupStartTime": 1518307200000,
197
"pickupEndTime": 1518310800000,
198
"dropoffStartTime": 1518310800000,
199
"dropoffEndTime": 1518314400000,
200
"expiration": 30,
201
"pickupMaxAvailableTime": 1518314400000,
202
"isFlexible": false,
203
"companyId": "654",
204
"size": [
205
"3"
206
],
207
"distance": [
208
"5.1"
209
],
210
"subtotal": [
211
"3.26"
212
]
213
},
214
{
215
"quoteId": 136510,
216
"city": 2,
217
"pickup": [
218
{
219
"contact": {
220
"name": "Wander b",
221
"email": "[email protected]"
222
},
223
"location": {
224
"instructions": "Av. Francisco de Orellana, Guayaquil 090512",
225
"address": "Av. Francisco de Orellana, Guayaquil, Ecuador",
226
"lat": -2.1629639,
227
"lng": -79.89776359999999
228
}
229
}
230
],
231
"dropoff": [
232
{
233
"contact": {
234
"name": "Andres b",
235
"email": "[email protected]"
236
},
237
"location": {
238
"instructions": "Sauces 9, Guayaquil",
239
"address": "Sauces 9, Guayaquil 090505, Ecuador",
240
"lat": -2.1323186,
241
"lng": -79.8926809
242
}
243
}
244
],
245
"cost": 3.26,
246
"currencyCode": "USD",
247
"currency": "USD",
248
"pickupStartTime": 1518310800000,
249
"pickupEndTime": 1518314400000,
250
"dropoffStartTime": 1518314400000,
251
"dropoffEndTime": 1518318000000,
252
"expiration": 30,
253
"pickupMaxAvailableTime": 1518318000000,
254
"isFlexible": false,
255
"companyId": "654",
256
"size": [
257
"3"
258
],
259
"distance": [
260
"5.1"
261
],
262
"subtotal": [
263
"3.26"
264
]
265
}
266
],
267
"express": {
268
"quoteId": 136514,
269
"city": 2,
270
"pickup": [
271
{
272
"contact": {
273
"name": "Wander b",
274
"email": "[email protected]"
275
},
276
"location": {
277
"instructions": "Av. Francisco de Orellana, Guayaquil 090512",
278
"address": "Av. Francisco de Orellana, Guayaquil, Ecuador",
279
"lat": -2.1629639,
280
"lng": -79.89776359999999
281
}
282
}
283
],
284
"dropoff": [
285
{
286
"contact": {
287
"name": "Andres b",
288
"email": "[email protected]"
289
},
290
"location": {
291
"instructions": "Sauces 9, Guayaquil",
292
"address": "Sauces 9, Guayaquil 090505, Ecuador",
293
"lat": -2.1323186,
294
"lng": -79.8926809
295
}
296
}
297
],
298
"cost": 3.26,
299
"currencyCode": "USD",
300
"currency": "USD",
301
"pickupStartTime": 1518304378591,
302
"pickupEndTime": 1518306178591,
303
"dropoffStartTime": 1518306178591,
304
"dropoffEndTime": 1518307978591,
305
"expiration": 30,
306
"pickupMaxAvailableTime": 1518307978591,
307
"isFlexible": false,
308
"companyId": "654",
309
"size": [
310
"3"
311
],
312
"distance": [
313
"5.1"
314
],
315
"subtotal": [
316
"3.26"
317
]
318
},
319
"flex": {
320
"quoteId": 136497,
321
"city": 2,
322
"pickup": [
323
{
324
"contact": {
325
"name": "Wander b",
326
"email": "[email protected]"
327
},
328
"location": {
329
"instructions": "Av. Francisco de Orellana, Guayaquil 090512",
330
"address": "Av. Francisco de Orellana, Guayaquil, Ecuador",
331
"lat": -2.1629639,
332
"lng": -79.89776359999999
333
}
334
}
335
],
336
"dropoff": [
337
{
338
"contact": {
339
"name": "Andres b",
340
"email": "[email protected]"
341
},
342
"location": {
343
"instructions": "Sauces 9, Guayaquil",
344
"address": "Sauces 9, Guayaquil 090505, Ecuador",
345
"lat": -2.1323186,
346
"lng": -79.8926809
347
}
348
}
349
],
350
"cost": 3.26,
351
"currencyCode": "USD",
352
"currency": "USD",
353
"pickupStartTime": 1518008400000,
354
"pickupEndTime": 1518026400000,
355
"dropoffStartTime": 1518026400000,
356
"dropoffEndTime": 1518044400000,
357
"expiration": 30,
358
"pickupMaxAvailableTime": 1518030000000,
359
"isFlexible": true,
360
"companyId": "654",
361
"size": [
362
"3"
363
],
364
"distance": [
365
"5.1"
366
],
367
"subtotal": [
368
"3.26"
369
]
370
},
371
"steps": {}
372
}
373
}
Copied!
1
{
2
message: "quotes created successfully",
3
payload: {
4
"slots": [
5
{
6
"quoteId": 136498,
7
"city": 2,
8
"pickup": [
9
{
10
"contact": {
11
"name": "Wander b",
12
"email": "[email protected]"
13
},
14
"location": {
15
"instructions": "Av. Francisco de Orellana, Guayaquil 090512",
16
"address": "Av. Francisco de Orellana, Guayaquil, Ecuador",
17
"lat": -2.1629639,
18
"lng": -79.89776359999999
19
}
20
}
21
],
22
"dropoff": [
23
{
24
"contact": {
25
"name": "Andres b",
26
"email": "[email protected]"
27
},
28
"location": {
29
"instructions": "Sauces 9, Guayaquil",
30
"address": "Sauces 9, Guayaquil 090505, Ecuador",
31
"lat": -2.1323186,
32
"lng": -79.8926809
33
}
34
}
35
],
36
"cost": 3.26,
37
"currencyCode": "USD",
38
"currency": "USD",
39
"pickupStartTime": 1518267600000,
40
"pickupEndTime": 1518271200000,
41
"dropoffStartTime": 1518271200000,
42
"dropoffEndTime": 1518274800000,
43
"expiration": 30,
44
"pickupMaxAvailableTime": 1518274800000,
45
"isFlexible": false,
46
"companyId": "654",
47
"size": [
48
"3"
49
],
50
"distance": [
51
"5.1"
52
],
53
"subtotal": [
54
"3.26"
55
]
56
},
57
58
{
59
"quoteId": 136507,
60
"city": 2,
61
"pickup": [
62
{
63
"contact": {
64
"name": "Wander b",
65
"email": "[email protected]"
66
},
67
"location": {
68
"instructions": "Av. Francisco de Orellana, Guayaquil 090512",
69
"address": "Av. Francisco de Orellana, Guayaquil, Ecuador",
70
"lat": -2.1629639,
71
"lng": -79.89776359999999
72
}
73
}
74
],
75
"dropoff": [
76
{
77
"contact": {
78
"name": "Andres b",
79
"email": "[email protected]"
80
},
81
"location": {
82
"instructions": "Sauces 9, Guayaquil",
83
"address": "Sauces 9, Guayaquil 090505, Ecuador",
84
"lat": -2.1323186,
85
"lng": -79.8926809
86
}
87
}
88
],
89
"cost": 3.26,
90
"currencyCode": "USD",
91
"currency": "USD",
92
"pickupStartTime": 1518300000000,
93
"pickupEndTime": 1518303600000,
94
"dropoffStartTime": 1518303600000,
95
"dropoffEndTime": 1518307200000,
96
"expiration": 30,
97
"pickupMaxAvailableTime": 1518307200000,
98
"isFlexible": false,
99
"companyId": "654",
100
"size": [
101
"3"
102
],
103
"distance": [
104
"5.1"
105
],
106
"subtotal": [
107
"3.26"
108
]
109
},
110
{
111
"quoteId": 136508,
112
"city": 2,
113
"pickup": [
114
{
115
"contact": {
116
"name": "Wander b",
117
"email": "[email protected]"
118
},
119
"location": {
120
"instructions": "Av. Francisco de Orellana, Guayaquil 090512",
121
"address": "Av. Francisco de Orellana, Guayaquil, Ecuador",
122
"lat": -2.1629639,
123
"lng": -79.89776359999999
124
}
125
}
126
],
127
"dropoff": [
128
{
129
"contact": {
130
"name": "Andres b",
131
"email": "[email protected]"
132
},
133
"location": {
134
"instructions": "Sauces 9, Guayaquil",
135
"address": "Sauces 9, Guayaquil 090505, Ecuador",
136
"lat": -2.1323186,
137
"lng": -79.8926809
138
}
139
}
140
],
141
"cost": 3.26,
142
"currencyCode": "USD",
143
"currency": "USD",
144
"pickupStartTime": 1518303600000,
145
"pickupEndTime": 1518307200000,
146
"dropoffStartTime": 1518307200000,
147
"dropoffEndTime": 1518310800000,
148
"expiration": 30,
149
"pickupMaxAvailableTime": 1518310800000,
150
"isFlexible": false,
151
"companyId": "654",
152
"size": [
153
"3"
154
],
155
"distance": [
156
"5.1"
157
],
158
"subtotal": [
159
"3.26"
160
]
161
},
162
{
163
"quoteId": 136509,
164
"city": 2,
165
"pickup": [
166
{
167
"contact": {
168
"name": "Wander b",
169
"email": "[email protected]"
170
},
171
"location": {
172
"instructions": "Av. Francisco de Orellana, Guayaquil 090512",
173
"address": "Av. Francisco de Orellana, Guayaquil, Ecuador",
174
"lat": -2.1629639,
175
"lng": -79.89776359999999
176
}
177
}
178
],
179
"dropoff": [
180
{
181
"contact": {
182
"name": "Andres b",
183
"email": "[email protected]"
184
},
185
"location": {
186
"instructions": "Sauces 9, Guayaquil",
187
"address": "Sauces 9, Guayaquil 090505, Ecuador",
188
"lat": -2.1323186,
189
"lng": -79.8926809
190
}
191
}
192
],
193
"cost": 3.26,
194
"currencyCode": "USD",
195
"currency": "USD",
196
"pickupStartTime": 1518307200000,
197
"pickupEndTime": 1518310800000,
198
"dropoffStartTime": 1518310800000,
199
"dropoffEndTime": 1518314400000,
200
"expiration": 30,
201
"pickupMaxAvailableTime": 1518314400000,
202
"isFlexible": false,
203
"companyId": "654",
204
"size": [
205
"3"
206
],
207
"distance": [
208
"5.1"
209
],
210
"subtotal": [
211
"3.26"
212
]
213
},
214
{
215
"quoteId": 136510,
216
"city": 2,
217
"pickup": [
218
{
219
"contact": {
220
"name": "Wander b",
221
"email": "[email protected]"
222
},
223
"location": {
224
"instructions": "Av. Francisco de Orellana, Guayaquil 090512",
225
"address": "Av. Francisco de Orellana, Guayaquil, Ecuador",
226
"lat": -2.1629639,
227
"lng": -79.89776359999999
228
}
229
}
230
],
231
"dropoff": [
232
{
233
"contact": {
234
"name": "Andres b",
235
"email": "[email protected]"
236
},
237
"location": {
238
"instructions": "Sauces 9, Guayaquil",
239
"address": "Sauces 9, Guayaquil 090505, Ecuador",
240
"lat": -2.1323186,
241
"lng": -79.8926809
242
}
243
}
244
],
245
"cost": 3.26,
246
"currencyCode": "USD",
247
"currency": "USD",
248
"pickupStartTime": 1518310800000,
249
"pickupEndTime": 1518314400000,
250
"dropoffStartTime": 1518314400000,
251
"dropoffEndTime": 1518318000000,
252
"expiration": 30,
253
"pickupMaxAvailableTime": 1518318000000,
254
"isFlexible": false,
255
"companyId": "654",
256
"size": [
257
"3"
258
],
259
"distance": [
260
"5.1"
261
],
262
"subtotal": [
263
"3.26"
264
]
265
}
266
],
267
"express": {
268
"quoteId": 136514,
269
"city": 2,
270
"pickup": [
271
{
272
"contact": {
273
"name": "Wander b",
274
"email": "[email protected]"
275
},
276
"location": {
277
"instructions": "Av. Francisco de Orellana, Guayaquil 090512",
278
"address": "Av. Francisco de Orellana, Guayaquil, Ecuador",
279
"lat": -2.1629639,
280
"lng": -79.89776359999999
281
}
282
}
283
],
284
"dropoff": [
285
{
286
"contact": {
287
"name": "Andres b",
288
"email": "[email protected]"
289
},
290
"location": {
291
"instructions": "Sauces 9, Guayaquil",
292
"address": "Sauces 9, Guayaquil 090505, Ecuador",
293
"lat": -2.1323186,
294
"lng": -79.8926809
295
}
296
}
297
],
298
"cost": 3.26,
299
"currencyCode": "USD",
300
"currency": "USD",
301
"pickupStartTime": 1518304378591,
302
"pickupEndTime": 1518306178591,
303
"dropoffStartTime": 1518306178591,
304
"dropoffEndTime": 1518307978591,
305
"expiration": 30,
306
"pickupMaxAvailableTime": 1518307978591,
307
"isFlexible": false,
308
"companyId": "654",
309
"size": [
310
"3"
311
],
312
"distance": [
313
"5.1"
314
],
315
"subtotal": [
316
"3.26"
317
]
318
},
319
"flex": {
320
"quoteId": 136497,
321
"city": 2,
322
"pickup": [
323
{
324
"contact": {
325
"name": "Wander b",
326
"email": "[email protected]"
327
},
328
"location": {
329
"instructions": "Av. Francisco de Orellana, Guayaquil 090512",
330
"address": "Av. Francisco de Orellana, Guayaquil, Ecuador",
331
"lat": -2.1629639,
332
"lng": -79.89776359999999
333
}
334
}
335
],
336
"dropoff": [
337
{
338
"contact": {
339
"name": "Andres b",
340
"email": "[email protected]"
341
},
342
"location": {
343
"instructions": "Sauces 9, Guayaquil",
344
"address": "Sauces 9, Guayaquil 090505, Ecuador",
345
"lat": -2.1323186,
346
"lng": -79.8926809
347
}
348
}
349
],
350
"cost": 3.26,
351
"currencyCode": "USD",
352
"currency": "USD",
353
"pickupStartTime": 1518008400000,
354
"pickupEndTime": 1518026400000,
355
"dropoffStartTime": 1518026400000,
356
"dropoffEndTime": 1518044400000,
357
"expiration": 30,
358
"pickupMaxAvailableTime": 1518030000000,
359
"isFlexible": true,
360
"companyId": "654",
361
"size": [
362
"3"
363
],
364
"distance": [
365
"5.1"
366
],
367
"subtotal": [
368
"3.26"
369
]
370
},
371
"steps": {}
372
}
373
}
Copied!
400|Bad Request
curl
JavaScript
1
{
2
message: "Bad Request",
3
payload: { }
4
}
Copied!
1
{
2
message: "Bad Request",
3
payload: { }
4
}
Copied!
500|Internal Server error
curl
JavaScript
1
{
2
message: "Error while retrieving the quote",
3
payload: { }
4
}
Copied!
1
{
2
message: "Error while retrieving the quote",
3
payload: { }
4
}
Copied!
Last modified 1yr ago