Accept Quote
Accepting a quote schedules the parcel in DashLink’s system and finalizes the tracking code. Until accepted, a quote is not an active shipment and cannot be injected into DashLink operations.
Endpoint
POST /drive/v2/quotes/{external_delivery_id}/accept
external_delivery_id must match the ID returned in the quote response.
Request Behavior
Accepting the quote:
- Creates the parcel in DashLink
- Finalizes the tracking code
- Locks the scheduling fields
- Produces a create-delivery–style response
- Returns shipping label (if enabled)
Important:
- Quotes will be valid for five minutes. If quotes are not accepted within that timeline, you must generate a new quote or use the create-delivery endpoint directly.
- If you are passing a unique value (as oppossed to DD generated) to the external delivery id, you will need to call the create delivery endpoint using that unique value.
Idempotency
- Accepting an already-accepted quote returns the existing scheduled delivery.
- Accepting a quote after the 5-minute window returns an error.
Differences
Accept responses behave like create-delivery responses except:
dropoff_address_componentsis NOT included (If you need corrected components, store them from the quote response.)
Response Fields
In addition to the quote request fields returned in the response, the fields below are either only sent in the response or possibly updated from the request inputs sent.
A sample response found in the Accept Quote Example appendix.
| Field | Type | Description |
|---|---|---|
external_delivery_id | string | Echoed unique delivery ID generated by the caller. |
delivery_status | string | Always "created" for this endpoint. |
fee | integer (cents) | Delivery fee in lowest currency denomination (e.g. $5.99 → 599). |
fee_components | array | Breakdown of individual fee components that make up the total fee. |
fee_components.type | string | Type of fee: "package_fee", "fuel_surcharge", or "delivery_area_surcharge". |
fee_components.amount | integer (cents) | Amount for this fee component in lowest currency denomination. |
dropoff_address | string | Full comma-separated delivery address returned by geocoding. |
dropoff_location.lat | integer | Latitude returned by geocoding for precise navigation. |
dropoff_location.lng | integer | Longitude returned by geocoding for precise navigation. |
updated_at | string (ISO-8601) | Timestamp indicating when the delivery record was last updated. |
pickup_time_estimated | string (ISO-8601) | Estimated pickup time, if available. |
dropoff_time_estimated | string (ISO-8601) | Estimated delivery time, if available. |
support_reference | string | Internal DashLink support reference ID. |
tracking_url | string | Customer-facing tracking page URL. |
shipping_label.label_format | string | Label format (e.g. "zpl"). |
shipping_label.label_size | string | Label size (e.g. "4x6"). |
shipping_label.print_density | string | Print density (e.g. "203dpi"). |
shipping_label.label_string | string (base64) | Base64-encoded shipping label string. |
action_if_undeliverable | string | What DashLink should do if the parcel cannot be delivered. All parcel shipments use: "return_to_pickup", parcels are never disposed or left behind unless configured differently. |
Note: Not all fields that may be returned by the Drive API are listed above.
This table includes only the fields relevant to the DashLink parcel use case.