Skip to content
Delivr Developers

Overview

Retailer checkout delivery (on demand and service windows).

Delivr Merchant API 2026-11-01

Section titled “Delivr Merchant API 2026-11-01”

Quote deliveries from your stores, book them, report fulfilment, cancel, and receive signed webhooks. The integration guide is https://docs.delivr.no.

  • JSON only, camelCase. Request bodies are strict: an unknown field is 422 invalid_request with param naming it.
  • Money is in minor units (øre), VAT included; vatMinor/exVatMinor when split.
  • Times are RFC 3339 (answered in UTC). timeZone is the market’s IANA zone for display.
  • Every answer carries Delivr-Api-Version (this document’s version), X-Request-Id and, once signed in, RateLimit-* headers.
  • Every write except POST /quotes needs an Idempotency-Key.

Information

  • License: Proprietary
  • OpenAPI version: 3.1.0

Operations

Section titled “Operations”
GET
/v1/merchant/availability
GET
/v1/merchant/locations
POST
/v1/merchant/quotes
POST
/v1/merchant/locations
GET
/v1/merchant/locations/{location}
PATCH
/v1/merchant/locations/{location}
GET
/v1/merchant/orders
POST
/v1/merchant/orders
GET
/v1/merchant/orders/{order}
POST
/v1/merchant/orders/{order}/processing
POST
/v1/merchant/orders/{order}/ready
GET
/v1/merchant/orders/{order}/cancellation
POST
/v1/merchant/orders/{order}/cancel
POST
/v1/merchant/orders
POST
/v1/merchant/orders/{order}/sale
POST
/v1/merchant/orders/{order}/cancel
GET
/v1/merchant/webhook
PUT
/v1/merchant/webhook/events
GET
/v1/merchant/webhooks/deliveries
POST
/v1/merchant/webhooks/events/{event}/replay
POST
/v1/merchant/webhooks/test
POST
Held for a pending sale (assisted checkout) WEBHOOK
POST
Order placed WEBHOOK
POST
Window order booked on its window WEBHOOK
POST
On demand, goods released, driver search started WEBHOOK
POST
On demand, a driver accepted WEBHOOK
POST
Goods picked up WEBHOOK
POST
Delivered (with proofOfDelivery) WEBHOOK
POST
Cancelled (with reason) WEBHOOK
POST
Failed (with reason); your fallback policy may follow WEBHOOK
POST
You stated when the goods will be ready (readyAt) WEBHOOK
POST
Goods due and not reported ready WEBHOOK
POST
Booked on another window than quoted (previousWindow) WEBHOOK
POST
A failed order got a window successor (successorId) WEBHOOK
POST
Recipient may choose a window until choiceDeadline WEBHOOK
POST
No successor follows the failed order (fallbackReason) WEBHOOK
POST
Test delivery (data.test true, no order) WEBHOOK

Authentication

Section titled “Authentication”

apiKey

Section titled “apiKey”

Authorization: Bearer dmk_..., issued by Delivr (shown once). Scope quotes: availability, reading locations, quotes (for a widget backend). Scope orders: everything. Server-side only.

Security scheme type: http

Bearer format: dmk_<43 base64url chars>

© 2026 Delivr ASSupportChangelogOpenAPIllms.txt