Request more time for an order (Need More Time)

put

https://api.developers.deliveroo.com/picking/v1/orders/{order_id}/request-more-time

Summary

Signals that the picker needs additional preparation time for an order. Deliveroo adjusts dispatch timing so that rider arrival better aligns with order readiness.

Usage scenario

While picking, the site realises an order will take longer than expected and requests a number of additional minutes.

Business constraints

Only available for ORCA / Just-In-Time orders (rider_assignment_flow is JUST_IN_TIME).
Need More Time must be enabled for the site.
The order must not have reached a terminal status.
Need More Time will not work if a rider has already been assigned.
One request per order: a successful call locks the order against further requests. Choose the value carefully — there is no top-up.

Operational constraints

There's a rate limit of 2 requests per order per second. If you get over the limit, you'll get a "Too many requests" error.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Responses

Language

Credentials

OAuth2

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Need More Time was granted.

400The request was invalid. Possible code values: INVALID_ARGUMENT — additional_minutes is missing or not a positive integer. INVALID_DELAY — the requested minutes were rejected by the downstream dispatch service.

401The request didn't work because the combination of your API key and API token doesn't exist in our system or your integration has been disabled

404Order with that ID was not found in our systems.

409The order can no longer accept more time. Possible code values: ORDER_TERMINAL_STATUS — the order has reached a terminal status (accepted, rejected, cancelled). RIDER_ALREADY_ASSIGNED — a rider has already been assigned to the order, so more time can no longer be granted.

422The request was understood but cannot be fulfilled. Possible code values: NOT_ORCA_ORDER — the order is not an ORCA / Just-In-Time order. NMT_ALREADY_REQUESTED — Need More Time has already been requested for this order.

429Too many requests. Rate limit of 2 requests / second / 1 order is exceeded

500Something went wrong on our end. You'll have to try again later once we've fixed it.