Skip to content

Choose another delivery day

POST
/track/day
curl --request POST \
--url https://example.com/track/day \
--header 'Content-Type: application/json' \
--data '{ "ref": "7K3M9-QWXZ2", "postcode": "KT3 4BP", "day": "2026-11-20" }'

Deliberately unauthenticated, checked the same way as reading. The customer chooses a day from tomorrow, up to 60 days ahead. When the business lets customers change the day, and no driver or delivery partner has been sent the order yet, it moves to that day and comes off any round still being planned. Otherwise the business is asked and nothing moves. The business is told either way. Refused once the driver has set off.

Media typeapplication/json
object
ref
required
string
>= 4 characters <= 24 characters

Example

7K3M9-QWXZ2
postcode
required
string
>= 3 characters <= 12 characters

Example

KT3 4BP
day
required
string format: date

Example

2026-11-20

Moved, or asked for, with where the order is now

Media typeapplication/json
object
outcome
required
string
Allowed values: changed asked
tracking
required
object
ref
required
string
business
required
string
fulfilment
required
string
Allowed values: delivery collection
postcode
required
string | null
items
required
Array<string>
status
required
string
Allowed values: awaiting_payment waiting planned on_the_way not_today delivered cancelled
day
required
string | null format: date
expected
required
object
from
required
string format: date
to
required
string format: date
window
required
object
from
required
string
/^([01]\d|2[0-3]):[0-5]\d$/
to
required
string
/^([01]\d|2[0-3]):[0-5]\d$/
position
required
object
yours
required
integer
> 0
total
required
integer
> 0
driverOn
required
integer | null
> 0
deliveredAt
required
string | null format: date-time
location
required
object
latitude
required
number
>= -90 <= 90
longitude
required
number
>= -180 <= 180
van
required
object
latitude
required
number
longitude
required
number
seenAt
required
string format: date-time
leave
required
object
instruction
required
string | null
Allowed values: none neighbour safe_place
detail
required
string | null
canSaveToAddress
required
boolean
deliveredByHand
required
boolean
dayChange
required
string | null
Allowed values: change ask

Example

{
"outcome": "changed",
"tracking": {
"ref": "7K3M9-QWXZ2",
"fulfilment": "delivery",
"items": [
"2 × 19kg propane"
],
"status": "awaiting_payment",
"window": {
"from": "07:30",
"to": "07:30"
},
"leave": {
"instruction": "none"
},
"dayChange": "change"
}
}

No order with that reference at that postcode

Media typeapplication/json
object
error
required
string
message
required
string

Example

{
"error": "not_found",
"message": "Customer not found"
}

Too late to change the day here

Media typeapplication/json
object
error
required
string
message
required
string

Example

{
"error": "not_found",
"message": "Customer not found"
}

Validation failed

Media typeapplication/json
object
error
required
string
Allowed values: validation
message
required
string
issues
required
Array<object>
object
path
required
string
message
required
string

Example

{
"error": "validation",
"issues": [
{
"path": "email",
"message": "Invalid email"
}
]
}

Too many attempts from one place

Media typeapplication/json
object
error
required
string
message
required
string

Example

{
"error": "not_found",
"message": "Customer not found"
}