Get Delivery Status

DashLink provides two different tracking endpoints, each serving a different purpose:

1. Unauthenticated tracking history (geteventhistory)
2. Authenticated Drive delivery status

---

Recommended usage pattern

Need	Endpoint
Full history	geteventhistory
Customer-facing tracking	geteventhistory
Proof of delivery image	Authenticated status endpoint
Dasher location / vehicle details	Authenticated status endpoint
Troubleshooting	Both

---

Endpoint #1 — Unauthenticated event history (recommended for tracking)

GET /webhooks/drive/geteventhistory/{external_delivery_id}

Use cases:

• Retrieve the full event history
• Build customer tracking pages
• QA and debugging
• Map webhook-based states

This endpoint returns all parcel lifecycle events such as:

• parcel_labeled
• parcel_scanned
• parcel_mid_mile_arrived
• dasher_picked_up
• dasher_dropped_off
• Redelivery and failure events

Returned data includes:

• event_name
• Timestamp
• Location (city, state, ZIP)
• Sequence of events

Example response:

{
    "eventHistory": [
        {
            "event_name": "parcel_labeled",
            "timestamp": "2025-12-05T17:09:45Z"
        },
        {
            "event_name": "parcel_awaiting",
            "timestamp": "2025-12-05T17:12:43Z"
        },
        {
            "event_name": "parcel_scanned",
            "timestamp": "2025-12-05T17:12:43Z",
            "event_location": {
                "city_name": "Lewisville",
                "state": "TX",
                "postal_code": "75057"
            }
        },
        {
            "event_name": "dasher_picked_up",
            "timestamp": "2025-12-05T17:13:25Z"
        },
        {
            "event_name": "dasher_dropped_off",
            "timestamp": "2025-12-05T17:13:39Z"
        }
    ]
}

---

Endpoint #2 — Authenticated Drive delivery status

GET /drive/v2/deliveries/{external_delivery_id}

Use cases:

• Fetch current delivery metadata
• Access POD images (dropoff photo, signature)
• Retrieve dasher vehicle details
• Get updated delivery time estimates

This endpoint is not recommended for building tracking timelines because:

• It returns only the current status, not the full history
• Its status codes are tailored toward same-day restaurant deliveries
• Status Codes Returned:
  • quote
  • created
  • confirmed
  • enroute_to_pickup
  • arrived_at_pickup
  • picked_up
  • enroute_to_dropoff
  • arrived_at_dropoff
  • delivered
  • enroute_to_return
  • arrived_at_return
  • returned
  • cancelled

Example response:

{
    "external_delivery_id": "DDWQ44MS8XP19SH32",
    "currency": "USD",
    "delivery_status": "created",
    "fee": 1200,
    "order_fulfillment_method": "parcel",
    "pickup_address": "1301 Ridgeview Ste 100, Lewisville TX 75057-6018, United States",
    "pickup_business_name": "Best Clothing Brand",
    "pickup_phone_number": "+18003772753",
    "pickup_reference_tag": "DDWQ44MS8XP19SH32",
    "pickup_external_business_id": "BestClothingBrand",
    "pickup_external_store_id": "DAL-8",
    "dropoff_address": "1301 Ridgeview Ste 100, Lewisville TX 75057-6018, United States",
    "dropoff_location": {
        "lat": 33.02589,
        "lng": -96.980958333
    },
    "dropoff_phone_number": "+16505555555",
    "dropoff_instructions": "Enter gate code 1234 on the callbox.",
    "dropoff_contact_given_name": "John",
    "dropoff_contact_family_name": "Doe",
    "dropoff_contact_send_notifications": false,
    "order_value": 1999,
    "items": [
        {
            "name": "Package Name",
            "quantity": 1,
            "description": "Package Description",
            "external_id": "123-123443434b",
            "volume": 5.3,
            "weight": 2.0,
            "length": 16.0,
            "width": 10.0,
            "height": 12.0,
            "price": 1000,
            "barcode": "DDWQ44MS8XP19SH32"
        }
    ],
    "updated_at": "2025-12-05T17:09:44.773544Z",
    "pickup_time_estimated": "2025-12-09T19:42:32Z",
    "dropoff_time_estimated": "2025-12-09T20:00:00Z",
    "fee_components": [],
    "tax": 0,
    "tax_components": [],
    "support_reference": "2688724671",
    "tracking_url": "https://track.doordash.com/order/d8058802-5c5e-4d18-b5c3-9c802edf35b0/track",
    "shipping_label": {
        "label_format": "zpl",
        "label_size": "4x6",
        "print_density": "203dpi",
        "label_string": "XlhBCl5DRjAsNjAKXkZPNTAsNTBeRkRMb3VpcyBTaG9wXkZTCl5DRjAsMzAKXkZPNTAsMTE1XkZEU2hpcHBlZCAxMi8wNS8yNSB8IExPVUlTLVRYLTFeRlMKXkZPNjUwLDYwXkZEMi4wMCBsYnNeRlMKXkZPNjUwLDEwMF5GRERBTC04XkZTCl5GTzUwLDE3MF5HQjcwMCwzLDNeRlMKXkNGMCw2MApeRk81MCwyMjVeRkRKb2huIERvZV5GUwpeQ0ZBLDM2Cl5GTzUwLDMzMF5GRDEzMDEgUmlkZ2V2aWV3IFN0ZSAxMDBeRlMKXkZPNTAsMzg1XkZETGV3aXN2aWxsZV5GUwpeRk81MCw0NDBeRkRUWCwgNzUwNTdeRlMKXkZPNTAsNTIwXkdCNzAwLDMsM15GUwpeQlkzLDMsMjAwCl5GTzUwLDU3NV5CQ15GREREV1E0NE1TOFhQMTlTSDMyXkZTCl5CUU4sMiw3Cl5GTzU3NSw3NTBeRkRRQSxERFdRNDRNUzhYUDE5U0gzMl5GUwpeQ0ZBLDI0Cl5GTzUwLDg0NV5GRFJlZiMgMTIzLTEyMzQ0MzQzNGJeRlMKXkNGMCw0OF5GTzEwNSwxMDk1XkZERGFzaExpbmteRlMKXkNGMCwyMl5GTzUwLDEwOTVeRkRMQVNUXkZTCl5DRjAsMjJeRk81MCwxMTE1XkZETUlMRV5GUwpeWFo="
    },
    "contactless_dropoff": true,
    "action_if_undeliverable": "return_to_pickup",
    "tip": 0,
    "order_contains": {
        "alcohol": false,
        "pharmacy_items": false,
        "age_restricted_pharmacy_items": false,
        "tobacco": false,
        "hemp": false,
        "otc": false
    },
    "dropoff_requires_signature": false,
    "dropoff_cash_on_delivery": 0
}

---