Courier documentation

Courier puts a courier from a shared pool on the road for your delivery. These pages cover the partner API — quoting, booking and following deliveries from your own system — and guides to the merchant portal and the courier app.

Start here

Sandbox and API keysGet a test key and see what the sandbox does and doesn’t do.

QuickstartFrom a key to a booked delivery in a few minutes, with curl.

WebhooksHear about every delivery as it moves, signed and retried.

API referenceEvery endpoint, request and response, generated from the API itself.

How a delivery goes

1. Quote. Send the pickup and drop-off coordinates and a vehicle. You get a fixed price, valid for ten minutes.
2. Book. Book against the quote with the contact details for both ends. Your card is held for the price.
3. Follow. A courier nearby takes the offer. Webhooks tell you each step, or read the job whenever you like. Your customer gets a live tracking link.
4. Delivered. The courier records proof at the door and the charge on your card is taken.

Conventions

• Everything is JSON over HTTPS. Request and response fields are snake_case.
• Money is always in minor units — pence, cents, rials — as an integer, with an ISO currency code beside it. 950 with GBP is £9.50.
• Times are ISO 8601 with an offset, for example 2026-10-10T12:31:04+00:00.
• Identifiers are UUIDs. A job also has a short reference, such as JOB-7F3K2Q, for people.