Developers
API referenceBusiness sign in

Help

Changelog

Changes to the API, the SDK and these docs. Additive changes (new fields, events, codes) can arrive at any time; breaking changes get a new version.

7 November 2026

  • Receiver choices. Shipments and tracking gain receiverChanges (destination or fallback point changes and hold extensions made by the verified receiver) and overstay (hold end, day rate, cap, amount due and payment state).
  • New events: shipment.receiver_changed (data.receiver_change), shipment.overstay_started and shipment.overstay_paid (data.overstay). Overstay is worked out automatically at pickup; a contract that covers overstay pays from your wallet up to its limit.

6 November 2026

  • Relay Home Delivery bookable. RELAY_HOME quotes take the receiver's address (destinationAddressText, destinationPlaceId or destinationPin) and an optional fallbackLocationCode; without one, Qoene picks the nearest suitable Qoene Point. The price is the Relay route plus the area's home-delivery fee. Addresses outside a home-delivery area come back excluded with OUTSIDE_HOME_DELIVERY_AREA.
  • New events: shipment.home_attempt_failed and shipment.redirected_to_point, with data.home_delivery. After the one failed attempt, tracking follows the Relay Point steps at the fallback point.

5 November 2026

  • Analytics. GET /analytics/summary returns your own delivery performance (volume trend, on-time rate, delivery time by product and region, returns and claims rates, cost per parcel, overstay you covered and top destination regions) from hourly-rebuilt daily aggregates, with the new scope analytics.read. SDK: analytics.summary().
  • WooCommerce plugin. Qoene Delivery for WooCommerce: rates, the Qoene Point picker, the order inbox, shipments, labels, tracking and returns. See the WooCommerce guide.
  • New: POST /orders accepts checkoutSelection: the signed widget choice is attached to the order once, and the ship run books its quote at the shopper's price while it is valid. Orders gain checkout_selection_id; API orders in a WooCommerce store have source WOOCOMMERCE.
  • New: GET /locations/search accepts address in place of lat/lng, with the position used in geocoded.
  • Changed: POST /shipments refuses a selection attached to a LIVE order (409 CHECKOUT_SELECTION_ATTACHED): ship the order instead. TEST bookings with BUSINESS_INVOICE or BUSINESS_WALLET no longer fail with a 500.

4 November 2026

  • Returns launched. POST /returns, GET /returns, GET /returns/{returnId}, POST /returns/quote, GET /returns/policy and approve, reject and cancel, with scopes returns.read and returns.write. See the returns guide.
  • New events: return.requested, return.approved, return.rejected, return.cancelled, return.expired, return.dropped_off, return.in_transit, return.arrived, return.received, return.inspected, return.refund_recorded. EVENT_RESERVED and 501 RETURNS_NOT_AVAILABLE are gone.
  • SDK: returns.list, listAll, create, get, quote, policy, approve, reject, cancel.

3 November 2026

28 October 2026

  • Checkout widget from js.qoenedelivery.com: delivery options, promised dates and a Qoene Point picker inside your checkout, inline or as a popup. See the widget guide.
  • New: publishable keys (qd_pk_…, locked to your websites), POST /checkout/sessions, POST /checkout/selections/verify, GET /checkout/keys and the checkout.write scope.
  • New: POST /shipments accepts checkoutSelection (a signed widget selection) in place of quoteId.
  • SDK: qoene.checkout.* and verifyCheckoutSelection() for offline token checks.

27 October 2026

  • Developer docs at developers.qoenedelivery.com, generated from the OpenAPI document: guides, full reference, webhooks and code in Node.js, cURL, PHP and Python.
  • @qoene/delivery 0.1.0 TypeScript SDK (publishing to npm is being prepared).
  • New: GET /declarations/prohibited-items, so API-only shops can confirm the current declaration.
  • Docs: POST /quotes/options now documents its own request (serviceCodes; no service or serviceVariant).

API v1

  • Served at api.qoenedelivery.com/v1 with a public OpenAPI 3.1 document (51 operations, 56 webhook events).
  • Services, ranked point search, location detail, shipment list, store orders and ship runs, webhook endpoints by API key.
  • Events shipment.out_for_delivery, shipment.pickup_expiring, order.created, order.shipped, order.failed.

Versioning

The API version is in the path (/v1). Within v1 we only add: new endpoints, optional request fields, response fields, webhook events, milestone and error codes. Write your client to ignore unknown fields and handle unknown codes. Current document version: 1.0.0.