curl --request POST \
--url https://api.listo.delivery/v1/quotes \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"store_id": "st_4bR8kM2wQ7xT1nV5cZ9pLdYe",
"dropoff": {
"street": "Blvd. Puerta de Hierro 4965, Zapopan, Jalisco 45116",
"lat": 20.709395,
"lng": -103.413393,
"apt_unit": "Depto 4B"
},
"payment_method": "cash",
"order_value_cents": 19600,
"business_fee_share": 100,
"business_fee_cap_cents": 3000,
"vehicle": "car",
"manifest": {
"items": [
{
"name": "Tacos al pastor",
"quantity": 2
},
{
"name": "Refrigerador",
"quantity": 1,
"size": "xlarge"
}
]
},
"pickup_ready_at": "2026-07-29T00:25:00Z"
}
'import requests
url = "https://api.listo.delivery/v1/quotes"
payload = {
"store_id": "st_4bR8kM2wQ7xT1nV5cZ9pLdYe",
"dropoff": {
"street": "Blvd. Puerta de Hierro 4965, Zapopan, Jalisco 45116",
"lat": 20.709395,
"lng": -103.413393,
"apt_unit": "Depto 4B"
},
"payment_method": "cash",
"order_value_cents": 19600,
"business_fee_share": 100,
"business_fee_cap_cents": 3000,
"vehicle": "car",
"manifest": { "items": [
{
"name": "Tacos al pastor",
"quantity": 2
},
{
"name": "Refrigerador",
"quantity": 1,
"size": "xlarge"
}
] },
"pickup_ready_at": "2026-07-29T00:25:00Z"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
store_id: 'st_4bR8kM2wQ7xT1nV5cZ9pLdYe',
dropoff: {
street: 'Blvd. Puerta de Hierro 4965, Zapopan, Jalisco 45116',
lat: 20.709395,
lng: -103.413393,
apt_unit: 'Depto 4B'
},
payment_method: 'cash',
order_value_cents: 19600,
business_fee_share: 100,
business_fee_cap_cents: 3000,
vehicle: 'car',
manifest: {
items: [
{name: 'Tacos al pastor', quantity: 2},
{name: 'Refrigerador', quantity: 1, size: 'xlarge'}
]
},
pickup_ready_at: '2026-07-29T00:25:00Z'
})
};
fetch('https://api.listo.delivery/v1/quotes', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.listo.delivery/v1/quotes",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'store_id' => 'st_4bR8kM2wQ7xT1nV5cZ9pLdYe',
'dropoff' => [
'street' => 'Blvd. Puerta de Hierro 4965, Zapopan, Jalisco 45116',
'lat' => 20.709395,
'lng' => -103.413393,
'apt_unit' => 'Depto 4B'
],
'payment_method' => 'cash',
'order_value_cents' => 19600,
'business_fee_share' => 100,
'business_fee_cap_cents' => 3000,
'vehicle' => 'car',
'manifest' => [
'items' => [
[
'name' => 'Tacos al pastor',
'quantity' => 2
],
[
'name' => 'Refrigerador',
'quantity' => 1,
'size' => 'xlarge'
]
]
],
'pickup_ready_at' => '2026-07-29T00:25:00Z'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.listo.delivery/v1/quotes"
payload := strings.NewReader("{\n \"store_id\": \"st_4bR8kM2wQ7xT1nV5cZ9pLdYe\",\n \"dropoff\": {\n \"street\": \"Blvd. Puerta de Hierro 4965, Zapopan, Jalisco 45116\",\n \"lat\": 20.709395,\n \"lng\": -103.413393,\n \"apt_unit\": \"Depto 4B\"\n },\n \"payment_method\": \"cash\",\n \"order_value_cents\": 19600,\n \"business_fee_share\": 100,\n \"business_fee_cap_cents\": 3000,\n \"vehicle\": \"car\",\n \"manifest\": {\n \"items\": [\n {\n \"name\": \"Tacos al pastor\",\n \"quantity\": 2\n },\n {\n \"name\": \"Refrigerador\",\n \"quantity\": 1,\n \"size\": \"xlarge\"\n }\n ]\n },\n \"pickup_ready_at\": \"2026-07-29T00:25:00Z\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.listo.delivery/v1/quotes")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"store_id\": \"st_4bR8kM2wQ7xT1nV5cZ9pLdYe\",\n \"dropoff\": {\n \"street\": \"Blvd. Puerta de Hierro 4965, Zapopan, Jalisco 45116\",\n \"lat\": 20.709395,\n \"lng\": -103.413393,\n \"apt_unit\": \"Depto 4B\"\n },\n \"payment_method\": \"cash\",\n \"order_value_cents\": 19600,\n \"business_fee_share\": 100,\n \"business_fee_cap_cents\": 3000,\n \"vehicle\": \"car\",\n \"manifest\": {\n \"items\": [\n {\n \"name\": \"Tacos al pastor\",\n \"quantity\": 2\n },\n {\n \"name\": \"Refrigerador\",\n \"quantity\": 1,\n \"size\": \"xlarge\"\n }\n ]\n },\n \"pickup_ready_at\": \"2026-07-29T00:25:00Z\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.listo.delivery/v1/quotes")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"store_id\": \"st_4bR8kM2wQ7xT1nV5cZ9pLdYe\",\n \"dropoff\": {\n \"street\": \"Blvd. Puerta de Hierro 4965, Zapopan, Jalisco 45116\",\n \"lat\": 20.709395,\n \"lng\": -103.413393,\n \"apt_unit\": \"Depto 4B\"\n },\n \"payment_method\": \"cash\",\n \"order_value_cents\": 19600,\n \"business_fee_share\": 100,\n \"business_fee_cap_cents\": 3000,\n \"vehicle\": \"car\",\n \"manifest\": {\n \"items\": [\n {\n \"name\": \"Tacos al pastor\",\n \"quantity\": 2\n },\n {\n \"name\": \"Refrigerador\",\n \"quantity\": 1,\n \"size\": \"xlarge\"\n }\n ]\n },\n \"pickup_ready_at\": \"2026-07-29T00:25:00Z\"\n}"
response = http.request(request)
puts response.read_body{
"id": "qt_5nW3jP8vT2xQ6bM9cZ1sRdKe",
"fee_cents": 6844,
"business_fee_cents": 6844,
"customer_fee_cents": 0,
"cash_to_collect_cents": null,
"currency": "MXN",
"pickup_duration_min": 12,
"dropoff_eta_at": "2026-07-28T23:11:19Z",
"expires_at": "2026-07-28T22:36:55Z",
"test": true,
"created_at": "2026-07-28T22:25:00Z",
"vehicle": "moto"
}{
"error": {
"code": "invalid_api_key",
"message": "The API key is missing, revoked, or not valid for this mode.",
"param": null,
"retryable": false,
"doc_url": "https://docs.listo.delivery/en/errors/invalid_api_key",
"request_id": "0b1f6c9a-7e2d-4c53-9a41-5d8e3f2a6b10"
}
}{
"error": {
"code": "read_only_key",
"message": "This API key is read-only. Use a key without the read-only setting to create, change or cancel anything.",
"param": null,
"retryable": false,
"doc_url": "https://docs.listo.delivery/en/errors/read_only_key",
"request_id": "0b1f6c9a-7e2d-4c53-9a41-5d8e3f2a6b10"
}
}{
"error": {
"code": "not_found",
"message": "No resource with that id exists for this API key.",
"param": null,
"retryable": false,
"doc_url": "https://docs.listo.delivery/en/errors/not_found",
"request_id": "0b1f6c9a-7e2d-4c53-9a41-5d8e3f2a6b10"
}
}{
"error": {
"code": "pickup_point_pending",
"message": "This store's pickup point is not confirmed yet, so no courier can be requested from it. Retry the same request shortly.",
"param": null,
"retryable": true,
"doc_url": "https://docs.listo.delivery/en/errors/pickup_point_pending",
"request_id": "0b1f6c9a-7e2d-4c53-9a41-5d8e3f2a6b10"
}
}{
"error": {
"code": "cash_over_cap",
"message": "The cash amount is over the collection limit. Use card instead.",
"param": null,
"retryable": false,
"doc_url": "https://docs.listo.delivery/en/errors/cash_over_cap",
"request_id": "0b1f6c9a-7e2d-4c53-9a41-5d8e3f2a6b10"
}
}{
"error": {
"code": "provider_unavailable",
"message": "Dispatch is temporarily unavailable. Nothing was created. Retry.",
"param": null,
"retryable": true,
"doc_url": "https://docs.listo.delivery/en/errors/provider_unavailable",
"request_id": "0b1f6c9a-7e2d-4c53-9a41-5d8e3f2a6b10"
}
}Price a delivery
Prices a trip and holds that price for you to bind. The price is set at
the moment you ask for the quote: bind its id on the delivery create
and the order is charged the fee_cents and the split you were shown.
The courier network books the trip when the delivery is created, and
what it books can differ slightly from the price quoted. We book the
very quote you were shown whenever it is still valid, so this is rare.
When it happens, the difference appears on your ledger as its own line
(requote_adjustment, see GET /v1/ledger), negative when the booked
trip cost more and positive when it cost less. It never changes the
fee_cents, the split or the total of the order your customer sees.
Quotes expire, and expires_at tells you when. Binding an expired or
already-spent quote is a 400; request a new one. Binding is optional,
and a create without one is priced inline at whatever the price is then.
cash_to_collect_cents is what the courier collects at the door on a
cash order: the goods value plus the customer’s share of the fee.
business_fee_share and business_fee_cap_cents say how the delivery
fee is split between you and your customer. A prepaid quote is
different: you have already collected from your customer, so the whole
fee is yours and the split is fixed at 100 with no ceiling. A quote
that names no payment_method is priced the same way, because the only
delivery that can bind it is a prepaid one. On either, a
business_fee_share other than 100 is refused with 422 validation_failed naming business_fee_share, a valid
business_fee_cap_cents is ignored (one that is not a number is refused
as a shape error first), and a quote that sends neither is priced at
100, whatever your store’s default split is. That is the split a
prepaid delivery create books, so a quote you want to bind to a
prepaid delivery either names payment_method: prepaid or names no
method. To split the fee with your customer, name cash or card.
vehicle is moto (the default) or car. A car is a sedan: we can
guarantee a car, never a van, and there are fewer cars than motorcycles,
so one can take longer to assign. A car adds a surcharge that is INSIDE
fee_cents and split like the rest of the fee, so the number you are
quoted is the whole price; there is no separate line for it.
manifest.items is optional and takes the same {name, quantity, size} items the delivery create does. size is one of small (the
default), medium, large or xlarge, and it is the one field on an
item that can change the price: an item sized xlarge makes the trip
a car even when vehicle says moto. Nothing else does, weight
included. The response’s vehicle says which trip the fee is for,
whatever made it one. Send the quote the same cart you will create
with: the create is held to the vehicle this quote was priced as.
A cart too large for one courier trip is refused with 422 order_too_large, naming manifest.items, before anything is priced.
Split it across two deliveries.
Listo prices in Mexican pesos and delivers in Mexico. A store that turns
out to be somewhere else is refused here with 422 unsupported_country, which is final: it is not the retryable
provider_unavailable, and no retry of the same store can succeed. You
will only meet it on a store you positioned yourself, with lat/lng,
since a store we located is refused when you create it.
A store whose pickup point we cannot currently vouch for is refused
with 409 pickup_point_pending, because until it is confirmed a courier
could be sent to the wrong place. Usually the store’s address has just
changed and the confirmation has not landed yet, but not always, so do
not read it as “the merchant moved”. This one IS retryable: nothing
about your request is wrong, and the identical call succeeds once the
pickup point is confirmed. It refuses the store rather than the trip, so
a different dropoff will not help.
Retry it on a minutes-scale backoff, for a bounded number of attempts, and then put it in front of a human rather than keep polling. Most moves land within minutes on their own; a few are held up by something only our staff can clear and take considerably longer, and this response does not tell the two apart. The restaurant can also unblock it themselves from their own Listo console, which is usually the faster of the two.
When every courier near the trip is busy, the quote is refused with
409 no_couriers_available and nothing is priced. It is not an outage
and nothing about your request is wrong: it IS retryable, and the
identical call is priced once a courier is free, usually within
minutes. Retry it after a few minutes, for a bounded number of
attempts, and then tell whoever is waiting for the order rather than
keep polling. It is the same word a delivery that ended without a
courier carries in failure_reason.
A live store whose Plan Listo is not paid up is refused with 402 plan_required, because the create would refuse the delivery this
quote prices. error.message names the reason: no active plan, a
charge that is pending, a plan that ended on a given date, a plan whose
included deliveries for the cycle are all used, or a store that cannot
request couriers right now. It is not retryable: the identical call
fails until the plan is paid or restarted, or the cycle renews. See
Plan and billing.
curl --request POST \
--url https://api.listo.delivery/v1/quotes \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"store_id": "st_4bR8kM2wQ7xT1nV5cZ9pLdYe",
"dropoff": {
"street": "Blvd. Puerta de Hierro 4965, Zapopan, Jalisco 45116",
"lat": 20.709395,
"lng": -103.413393,
"apt_unit": "Depto 4B"
},
"payment_method": "cash",
"order_value_cents": 19600,
"business_fee_share": 100,
"business_fee_cap_cents": 3000,
"vehicle": "car",
"manifest": {
"items": [
{
"name": "Tacos al pastor",
"quantity": 2
},
{
"name": "Refrigerador",
"quantity": 1,
"size": "xlarge"
}
]
},
"pickup_ready_at": "2026-07-29T00:25:00Z"
}
'import requests
url = "https://api.listo.delivery/v1/quotes"
payload = {
"store_id": "st_4bR8kM2wQ7xT1nV5cZ9pLdYe",
"dropoff": {
"street": "Blvd. Puerta de Hierro 4965, Zapopan, Jalisco 45116",
"lat": 20.709395,
"lng": -103.413393,
"apt_unit": "Depto 4B"
},
"payment_method": "cash",
"order_value_cents": 19600,
"business_fee_share": 100,
"business_fee_cap_cents": 3000,
"vehicle": "car",
"manifest": { "items": [
{
"name": "Tacos al pastor",
"quantity": 2
},
{
"name": "Refrigerador",
"quantity": 1,
"size": "xlarge"
}
] },
"pickup_ready_at": "2026-07-29T00:25:00Z"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
store_id: 'st_4bR8kM2wQ7xT1nV5cZ9pLdYe',
dropoff: {
street: 'Blvd. Puerta de Hierro 4965, Zapopan, Jalisco 45116',
lat: 20.709395,
lng: -103.413393,
apt_unit: 'Depto 4B'
},
payment_method: 'cash',
order_value_cents: 19600,
business_fee_share: 100,
business_fee_cap_cents: 3000,
vehicle: 'car',
manifest: {
items: [
{name: 'Tacos al pastor', quantity: 2},
{name: 'Refrigerador', quantity: 1, size: 'xlarge'}
]
},
pickup_ready_at: '2026-07-29T00:25:00Z'
})
};
fetch('https://api.listo.delivery/v1/quotes', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.listo.delivery/v1/quotes",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'store_id' => 'st_4bR8kM2wQ7xT1nV5cZ9pLdYe',
'dropoff' => [
'street' => 'Blvd. Puerta de Hierro 4965, Zapopan, Jalisco 45116',
'lat' => 20.709395,
'lng' => -103.413393,
'apt_unit' => 'Depto 4B'
],
'payment_method' => 'cash',
'order_value_cents' => 19600,
'business_fee_share' => 100,
'business_fee_cap_cents' => 3000,
'vehicle' => 'car',
'manifest' => [
'items' => [
[
'name' => 'Tacos al pastor',
'quantity' => 2
],
[
'name' => 'Refrigerador',
'quantity' => 1,
'size' => 'xlarge'
]
]
],
'pickup_ready_at' => '2026-07-29T00:25:00Z'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.listo.delivery/v1/quotes"
payload := strings.NewReader("{\n \"store_id\": \"st_4bR8kM2wQ7xT1nV5cZ9pLdYe\",\n \"dropoff\": {\n \"street\": \"Blvd. Puerta de Hierro 4965, Zapopan, Jalisco 45116\",\n \"lat\": 20.709395,\n \"lng\": -103.413393,\n \"apt_unit\": \"Depto 4B\"\n },\n \"payment_method\": \"cash\",\n \"order_value_cents\": 19600,\n \"business_fee_share\": 100,\n \"business_fee_cap_cents\": 3000,\n \"vehicle\": \"car\",\n \"manifest\": {\n \"items\": [\n {\n \"name\": \"Tacos al pastor\",\n \"quantity\": 2\n },\n {\n \"name\": \"Refrigerador\",\n \"quantity\": 1,\n \"size\": \"xlarge\"\n }\n ]\n },\n \"pickup_ready_at\": \"2026-07-29T00:25:00Z\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.listo.delivery/v1/quotes")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"store_id\": \"st_4bR8kM2wQ7xT1nV5cZ9pLdYe\",\n \"dropoff\": {\n \"street\": \"Blvd. Puerta de Hierro 4965, Zapopan, Jalisco 45116\",\n \"lat\": 20.709395,\n \"lng\": -103.413393,\n \"apt_unit\": \"Depto 4B\"\n },\n \"payment_method\": \"cash\",\n \"order_value_cents\": 19600,\n \"business_fee_share\": 100,\n \"business_fee_cap_cents\": 3000,\n \"vehicle\": \"car\",\n \"manifest\": {\n \"items\": [\n {\n \"name\": \"Tacos al pastor\",\n \"quantity\": 2\n },\n {\n \"name\": \"Refrigerador\",\n \"quantity\": 1,\n \"size\": \"xlarge\"\n }\n ]\n },\n \"pickup_ready_at\": \"2026-07-29T00:25:00Z\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.listo.delivery/v1/quotes")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"store_id\": \"st_4bR8kM2wQ7xT1nV5cZ9pLdYe\",\n \"dropoff\": {\n \"street\": \"Blvd. Puerta de Hierro 4965, Zapopan, Jalisco 45116\",\n \"lat\": 20.709395,\n \"lng\": -103.413393,\n \"apt_unit\": \"Depto 4B\"\n },\n \"payment_method\": \"cash\",\n \"order_value_cents\": 19600,\n \"business_fee_share\": 100,\n \"business_fee_cap_cents\": 3000,\n \"vehicle\": \"car\",\n \"manifest\": {\n \"items\": [\n {\n \"name\": \"Tacos al pastor\",\n \"quantity\": 2\n },\n {\n \"name\": \"Refrigerador\",\n \"quantity\": 1,\n \"size\": \"xlarge\"\n }\n ]\n },\n \"pickup_ready_at\": \"2026-07-29T00:25:00Z\"\n}"
response = http.request(request)
puts response.read_body{
"id": "qt_5nW3jP8vT2xQ6bM9cZ1sRdKe",
"fee_cents": 6844,
"business_fee_cents": 6844,
"customer_fee_cents": 0,
"cash_to_collect_cents": null,
"currency": "MXN",
"pickup_duration_min": 12,
"dropoff_eta_at": "2026-07-28T23:11:19Z",
"expires_at": "2026-07-28T22:36:55Z",
"test": true,
"created_at": "2026-07-28T22:25:00Z",
"vehicle": "moto"
}{
"error": {
"code": "invalid_api_key",
"message": "The API key is missing, revoked, or not valid for this mode.",
"param": null,
"retryable": false,
"doc_url": "https://docs.listo.delivery/en/errors/invalid_api_key",
"request_id": "0b1f6c9a-7e2d-4c53-9a41-5d8e3f2a6b10"
}
}{
"error": {
"code": "read_only_key",
"message": "This API key is read-only. Use a key without the read-only setting to create, change or cancel anything.",
"param": null,
"retryable": false,
"doc_url": "https://docs.listo.delivery/en/errors/read_only_key",
"request_id": "0b1f6c9a-7e2d-4c53-9a41-5d8e3f2a6b10"
}
}{
"error": {
"code": "not_found",
"message": "No resource with that id exists for this API key.",
"param": null,
"retryable": false,
"doc_url": "https://docs.listo.delivery/en/errors/not_found",
"request_id": "0b1f6c9a-7e2d-4c53-9a41-5d8e3f2a6b10"
}
}{
"error": {
"code": "pickup_point_pending",
"message": "This store's pickup point is not confirmed yet, so no courier can be requested from it. Retry the same request shortly.",
"param": null,
"retryable": true,
"doc_url": "https://docs.listo.delivery/en/errors/pickup_point_pending",
"request_id": "0b1f6c9a-7e2d-4c53-9a41-5d8e3f2a6b10"
}
}{
"error": {
"code": "cash_over_cap",
"message": "The cash amount is over the collection limit. Use card instead.",
"param": null,
"retryable": false,
"doc_url": "https://docs.listo.delivery/en/errors/cash_over_cap",
"request_id": "0b1f6c9a-7e2d-4c53-9a41-5d8e3f2a6b10"
}
}{
"error": {
"code": "provider_unavailable",
"message": "Dispatch is temporarily unavailable. Nothing was created. Retry.",
"param": null,
"retryable": true,
"doc_url": "https://docs.listo.delivery/en/errors/provider_unavailable",
"request_id": "0b1f6c9a-7e2d-4c53-9a41-5d8e3f2a6b10"
}
}Authorizations
Your API key, sent as Authorization: Bearer <key>. Live and test keys are separate; the key you send decides which world the call acts in. To try calls, use a test key (it starts with lst_test_): no real courier is sent and no real money moves, but webhooks fire and the dropoff.phone you give can receive WhatsApp messages, so use your own number. A live key (it starts with lst_live_) books and charges real deliveries.
Body
The trip to price.
The st_ id of the store the courier collects from.
Where the order goes.
Show child attributes
Show child attributes
How the customer pays.
prepaid, cash, card The value of the order, in centavos. Required for a cash
quote, where it is what the courier collects.
x >= 0The percent of the delivery fee the store pays. Defaults to the store's own.
0 <= x <= 100The most the store pays toward the fee, in centavos.
x >= 0When the order will be ready, ISO-8601 in UTC. Must be in the future.
Defaults to moto.
moto, car The descriptive item list for the courier. Money never comes from it;
its only effect on the trip is that an xlarge item makes it a car.
Absent, null, {} and {"items": null} all mean no cart.
Show child attributes
Show child attributes
Response
Created.
A delivery priced and held for a short while. Hand id to
POST /v1/deliveries as quote_id to book at exactly this price.
The quote id, qt_ prefixed.
"qt_5nW3jP8vT2xQ6bM9cZ1sRdKe"
The total delivery fee, in centavos, and the number a booking
against this quote is held to. business_fee_cents plus
customer_fee_cents always add back to it.
The part of the fee the store pays.
The part of the fee the customer pays.
What the courier collects at the door on a cash order: the order
value plus the customer's share of the fee. Null on every quote
that is not a cash quote, which is not the same as 0 (a cash
order that collects nothing).
Always MXN; money is integer centavos.
MXN Minutes until a courier is expected at the store, when the quote came back with an estimate. Null otherwise.
When the order is expected at the door, when the quote came back with an estimate. Null otherwise.
The deadline for booking this price. Past it, a create answers
quote_expired and you quote again.
Whether the quote belongs to the sandbox world.
What this price was built for: car when you asked for one or an
item was sized xlarge, moto otherwise. Always present.
moto, car "moto"