For platforms and developers
Home deliveries
from your own system.
Connect your point of sale, your online store or your app to the Listo API. You get a quote, request the courier and follow every delivery from your own system, with cash collected at the door or a card payment link.
Request
POST /v1/deliveriesAuthorization: Bearer lst_test_••••••••••••Idempotency-Key: pedido-841 { "store_id": "st_4bR8kM2wQ7xT1nV5cZ9pLdYe", "external_id": "pedido-841", "payment_method": "cash", "order_value_cents": 19600, "business_fee_share": 0, "dropoff": { "name": "Ana Torres", "phone": "+523312345678", "street": "Av. Chapultepec 480, Guadalajara", "lat": 20.6719, "lng": -103.3682 }}Response
201 Created{ "id": "dlv_7hK2mQ9xR4tV6bN1cZ8sLwYe", "external_id": "pedido-841", "code": "LS-2004", "status": "dispatching", "payment": { "method": "cash", "cash_to_collect_cents": 26444 }, "fee_cents": 6844, "customer_fee_cents": 6844, "tracking_url": "https://app.listo.delivery/t/abc123", "test": true}POST /v1/quotes
Quote before
you promise
You send the delivery address and we return the exact fee and the estimated arrival time, before anything is created. If you create the delivery with that quote, the fee no longer changes.
Quote
qt_5nW3…RdKe
Delivery fee
$68.44
With this quote, the fee is locked
payment_method
Cash, card
or already paid
On every order you choose how your customer pays. With cash, the courier collects at the door. With a card, we give you a payment link and the courier leaves once it is paid. If you already collected, we just send the courier. You also decide who pays for the delivery.
How your customer pays
Who pays for the delivery
Webhooks
Every change reaches
your server
We notify you every time the delivery moves forward: courier assigned, on the way, delivered. Every change arrives signed, with the courier, the estimated time and, on delivery, the proof of delivery, and we retry it if your server doesn't answer. You also get the courier's location every 20 seconds, and your customer follows the order live on their own page.
Notices sent
LS-2004
X-Listo-Signature: t=1753728063,v1=9f2c…
If you connect several restaurants
You choose which balance
pays for each delivery
You decide it per store, from your partner dashboard or through the API, and it applies from the next delivery.
One balance, yours
You top up one balance and the deliveries of all your restaurants come out of it. They do not need a Listo account, and you decide how you charge them.
Your partner balance
$24,800.00
Pays the deliveries of your 3 stores
- You top up from your partner dashboard, by card or by SPEI
- You add your own margin to every delivery and it reaches you when it is delivered
- The cash couriers collect reaches your balance and you withdraw it by SPEI
Each restaurant with its own balance
The store has its own balance at Listo and its owner signs in to the merchant console. Your balance no longer pays for that store's deliveries.
- The owner tops up by card, by SPEI or with automatic top-up
- Withdraws to their bank what they collected in cash
- With full access they also dispatch from the console, and you still see every delivery
Price
One plan per branch,
and each delivery at its own fee
The same any restaurant pays at Listo. No commission per order.
Plan
$1,990
plus IVA a month
per branch
- One plan for each branch you connect, yours or your clients'
- You decide how much you charge your clients
- Your margin on every delivery is all yours
Deliveries
$54
plus IVA, the
first 3 km
- +$5 for each extra kilometer
- +$5 if the courier collects cash
- +$10 if the delivery goes by car
Test mode
$0
no time
limit
- Test keys from the first day
- A simulated courier drives every delivery
- The plan starts being charged when you go to production
Start in test mode
You integrate against the same API, without moving real money, until everything works.
- Step 1
Tell us about your platform
We give you access to the partner dashboard, where you create your keys and register the address of your webhooks.
- Step 2
Integrate in test mode
With your test keys, a simulated courier drives the whole delivery and you receive the same notices as in production. No real money.
- Step 3
Go to production
You switch to your production keys, register your branches and your deliveries start going out.
Documentation for your team
and for its AI
Step-by-step guides in Spanish and English, the reference for every endpoint and everything in formats an AI coding tool reads directly. It is public: your team can review it before talking to us.
api.listo.delivery/docs