Skip to main content

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 NameError
external_delivery_idDuplicate external delivery id: delivery_id from external_delivery_id
pickup_addressAddress is missing city field
pickup_addressAddress is missing state field
pickup_addressAddress is missing street field
pickup_addressAddress is missing zip_code field
pickup_addressCould not resolve to a valid address
pickup_addressDoorDash does not serve this area
pickup_addressPickup address not serviceable
dropoff_addressAddress is missing city field
dropoff_addressAddress is missing state field
dropoff_addressAddress is missing street field
dropoff_addressAddress is missing zip_code field
dropoff_addressAddress unit length is longer than 100 chars
dropoff_addressCould not resolve to a valid address
dropoff_addressDistance from pickup address to dropoff address exceeds X miles
dropoff_addressDropoff address not within service area
num_itemsOrder must contain at least 1 item
phone_numberPhone number provided does not seem to be a valid one
order_valuePlease enter a subtotal $X.XX or greater
order_valuePlease enter a subtotal $X.XX or lower
pickup_timeThe earliest Dasher pickup time is HH:MM AM/PM on the selected date
delivery_timeThe earliest Dasher pickup time is HH:MM AM/PM on the selected date
quoted_timeMust provide either a quoted delivery time or pickup time
allowed_vehiclesvehicle provided in allowed vehicles does not seem to be valid. Please check our Drive API doc.
cash_on_deliveryMax allowed cash value is $X
cash_on_deliveryThis store is not enabled for cash deliveries.
contains_alcoholAlcohol delivery is not supported for this store.
is_contactless_deliveryContactless delivery is not permitted when order contains alcohol
is_contactless_deliveryContactless delivery is not permitted for cash on delivery orders
is_contactless_deliveryContactless delivery is not permitted for signature_required orders
tip"tip cannot be greater than 100% of the order_value"
weightThe given weight is not a number: X
weightThe given weight must be less than limit: X
weightThe given weight must not be negative: X
volumeThe given volume is not a number: X
volumeThe given volume must be less than limit: X
volumeThe given volume must not be negative: X
priceThe given price is not an integer: X
priceThe given price must be less than limit: X
priceThe 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 MessageDescription
Delivery has been placedAs described in the error message
Delivery has been assignedDasher 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 upAs described in the message
Pickup address not located in a known servicable areaAs described in the error message
DoorDash is not open for delivery at the requested delivery timeAs described in the error message
DoorDash is not open for delivery at the requested pickup timeAs described in the error message
Cannot select pickup time after dropoff timeAs 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