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.

New here? Start with the quickstart and authentication.

Information

  • OpenAPI version: 3.1.0

Operations

Section titled “Operations”
GET
/v1/merchant/availability
POST
/v1/merchant/quotes
GET
/v1/merchant/locations
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/{order}/sale
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
order.held WEBHOOK
POST
order.placed WEBHOOK
POST
order.scheduled WEBHOOK
POST
order.searching WEBHOOK
POST
order.driver_assigned WEBHOOK
POST
order.picked_up WEBHOOK
POST
order.delivered WEBHOOK
POST
order.cancelled WEBHOOK
POST
order.failed WEBHOOK
POST
order.ready_at_changed WEBHOOK
POST
order.ready_overdue WEBHOOK
POST
order.window_changed WEBHOOK
POST
order.successor_created WEBHOOK
POST
order.awaiting_recipient WEBHOOK
POST
order.fallback_cancelled WEBHOOK
POST
webhook.test 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