Create and accept quotes

DoorDash Drive has two ways to create deliveries:

1. You can call the Create Delivery API directly, without first requesting a delivery quote
2. 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=...",
    ...
}

Flow diagram