Direct Delivery

Changelog

May 6, 2026

v1.0.0 Direct Delivery API GA

The Direct Delivery API is generally available. Retailers can now request quotes, submit deliveries, and subscribe to real-time status updates.

Added

Deliveries

  • POST /api/retailer/deliveries/quote: request a delivery quote with pickup ETA, delivery ETA, and a locked cost. Quotes are valid for 5 minutes.
  • POST /api/retailer/deliveries: consume a quote to create a delivery.
  • GET /api/retailer/deliveries: list deliveries for your retailer.
  • GET /api/retailer/deliveries/{external_delivery_id}: fetch a single delivery by your external ID.
  • PATCH /api/retailer/deliveries/{external_delivery_id}: update a delivery (cancellation supported in v1).

Webhooks

  • POST /api/retailer/webhooks: register a webhook URL. The signing secret is returned only once on creation.
  • GET /api/retailer/webhooks: view current configuration.
  • PUT /api/retailer/webhooks: update the URL or subscribed events.
  • DELETE /api/retailer/webhooks: remove the subscription.

Supported events:

  • pickup_status.changed: fires on each pickup status transition: ASSIGNED, EN_ROUTE_TO_STORE, ARRIVED_AT_STORE, WAITING_FOR_LOAD, LOADED, EN_ROUTE_TO_CUSTOMER, ARRIVED_AT_CUSTOMER, COMPLETED, FAILED, CANCELLED.
  • tracking_link.created: fires when a customer-facing tracking link is generated for a delivery.

Authentication

  • Bearer authentication using an API key generated in the Autolane Portal, scoped to your organization with granular permissions.
  • x-retailer-id header required on every request, set to the site UUID from the Autolane Portal.