Confirm booking

POST

/bookings/v4/{id}/confirm

• Production

Confirms a booking with the selected courier and pickup date. Once confirmed, the booking will be dispatched to the chosen courier and a connote number will be assigned. Optionally specify a tier for multi-tier pricing.

Authorizations

• apiKeyAuth
• basicAuth

Parameters

Path Parameters

id

required

integer

Example

12345678

Booking ID

Request Body ^required

object

courier

required

Courier identifier from the quotes object (e.g. allied, fastway, tnt)

string

Example

allied

pickup-date

required

Requested pickup date in YYYY-MM-DD format. Must be one of the dates from the quote’s pickup_dates array. Note: this field uses a hyphen, not an underscore.

string

Example

2026-02-17

pickup-time

Requested pickup time slot in HH:MM-HH:MM format (e.g. 09:00-17:00). Optional — pass the value from the courier’s pickup_time field.

string

Example

09:00-17:00

tier

Tier identifier for multi-tier pricing. Optional; omit or pass null for standard pricing.

integer | null

Example

{
  "courier": "allied",
  "pickup-date": "2026-02-17",
  "pickup-time": "09:00-17:00",
  "tier": null
}

Responses

204

Booking confirmed successfully

400

Validation error (e.g. invalid courier or pickup date)

object

error

Error code or type

string

Example

validation_error

message

Human-readable error message

string

Example

The sender postcode field is required.

401

Unauthorized

object

error

Error code or type

string

Example

validation_error

message

Human-readable error message

string

Example

The sender postcode field is required.

404

Booking not found

object

error

Error code or type

string

Example

validation_error

message

Human-readable error message

string

Example

The sender postcode field is required.