Create and accept quotes
DoorDash Drive has two ways to create deliveries:
- You can call the Create Delivery API directly, without first requesting a delivery quote
- You can call the Delivery Quote API and Accept Delivery Quote API
The second way is DoorDash's recommendation, as it allows you to confirm that a delivery is servicable and get back a price that you can show to the customer as part of a checkout process.
Quote​
Before you create a delivery, you can request a quote using the Delivery Quote API. When you request a quote, you provide the pickup and dropoff addresses and DoorDash will confirm that the addresses are in a serviceable area, calculate the delivery fee, and estimate the times for the order to be picked up and dropped off. You'll receive a response with the time estimates, the fees, and other delivery details:
{
... (other delivery details)
"delivery_status": "quote",
"pickup_time_estimated": "2018-08-22T17:20:28Z",
"dropoff_time_estimated": "2018-08-22T17:20:28Z",
"currency": "USD",
"fee": 1900,
...
}
Accept​
If the fee and time ranges are acceptable, you accept the quote when you're ready using the Accept Delivery Quote API. You can edit the tip
field as part of accepting a quote. Just pass it in the body of the request:
{
"tip": "600"
}
You'll receive a response with an updated delivery status and a tracking URL, among other data:
{
... (other delivery details)
"delivery_status": "created",
"tracking_url": "https://doordash.com/tracking?id=...",
...
}