Error codes and reasons

API: Drive (classic)

This doc covers the Drive (classic) API. If you're using the Drive API, see the reference guide for Drive errors.

Field Errors

Example error response format

{
    "field_errors": [
        {
        "field": "dropoff_address",
        "error": "Distance from pickup address to dropoff address exceeds 155 miles (250 kilometers)"
        }
    ]
}

The table below lists the possible field errors that are re-used across endpoints where the field is relevant

Field Name	Error
external_delivery_id	Duplicate external delivery id: `delivery_id` from `external_delivery_id`
pickup_address	Address is missing city field
pickup_address	Address is missing state field
pickup_address	Address is missing street field
pickup_address	Address is missing zip_code field
pickup_address	Could not resolve to a valid address
pickup_address	DoorDash does not serve this area
pickup_address	Pickup address not serviceable
dropoff_address	Address is missing city field
dropoff_address	Address is missing state field
dropoff_address	Address is missing street field
dropoff_address	Address is missing zip_code field
dropoff_address	Address unit length is longer than 100 chars
dropoff_address	Could not resolve to a valid address
dropoff_address	Distance from pickup address to dropoff address exceeds `X` miles
dropoff_address	Dropoff address not within service area
num_items	Order must contain at least 1 item
phone_number	Phone number provided does not seem to be a valid one
order_value	Please enter a subtotal `$X.XX` or greater
order_value	Please enter a subtotal `$X.XX` or lower
pickup_time	The earliest Dasher pickup time is `HH:MM AM/PM` on the selected date
delivery_time	The earliest Dasher pickup time is `HH:MM AM/PM` on the selected date
quoted_time	Must provide either a quoted delivery time or pickup time
allowed_vehicles	`vehicle` provided in allowed vehicles does not seem to be valid. Please check our Drive API doc.
cash_on_delivery	Max allowed cash value is `$X`
cash_on_delivery	This store is not enabled for cash deliveries.
contains_alcohol	Alcohol delivery is not supported for this store.
is_contactless_delivery	Contactless delivery is not permitted when order contains alcohol
is_contactless_delivery	Contactless delivery is not permitted for cash on delivery orders
is_contactless_delivery	Contactless delivery is not permitted for signature_required orders
tip	"tip cannot be greater than 100% of the order_value"
weight	The given weight is not a number: `X`
weight	The given weight must be less than `limit`: `X`
weight	The given weight must not be negative: `X`
volume	The given volume is not a number: `X`
volume	The given volume must be less than `limit`: `X`
volume	The given volume must not be negative: `X`
price	The given price is not an integer: `X`
price	The given price must be less than `limit`: `X`
price	The given price must not be negative: `X`

Non Field Errors

Example error response format

{
    "non_field_errors": [
        {
        "non_field_error": "A contract has not been recorded for this business. Please contact DoorDash for integration support"
        }
    ]
}

The table below lists the possible non field errors that are re-used across endpoints where the error is relevant

Error Message	Description
Delivery has been placed	As described in the error message
Delivery has been assigned	Dasher has already been assigned, hence the delivery cannot be updated at this point in time
Dasher cannot be unassigned because the order has already been picked up	As described in the message
Pickup address not located in a known servicable area	As described in the error message
DoorDash is not open for delivery at the requested delivery time	As described in the error message
DoorDash is not open for delivery at the requested pickup time	As described in the error message
Cannot select pickup time after dropoff time	As described in the error message
We are unable to fulfill this order due to insufficient Dashers in the area. Please try again later.	As described in the error message
A payment method has not been configured for this store.	Your store or business is missing critical configuration information. Your DoorDash account manager, if there is one, has been alerted. Feel free to also reach out to [email protected]
A contract has not been recorded for this business. Please contact DoorDash for integration support.	As described in the error message

Error codes and reasons

Field Errors​

Non Field Errors

Field Errors