Create Preparation Stage for an Order

post

https://api.developers.deliveroo.com/order/v1/orders/{order_id}/prep_stage

You can use this endpoint if you have a kitchen management system and want to update Deliveroo on how the preparation of the order is going. (detailed guide)

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

order_id

string

required

Related order id in format {market}:{order_uuid}.

Body Params

PrepStage body.

stage

string

enum

One of the possible preparation stage:

in_kitchen (Cooking has started)
ready_for_collection_soon (Food is a maximum of 60s from being ready to collect)
ready_for_collection (Food is cooked and packaged)
collected (The order has been collected)

Allowed:

occurred_at

string

The date/time (ISO-8601) the event occurred in UTC. Value must be within 1 hour in past from current UTC date/time or within 5 minutes in future from current UTC date/time. e.g. if current date/time is 15:00 occurred_at must be between 14:00 and 15:05

delay

uint64

Optional requested delay to prep time. Value must be either 0, 2, 4, 6, 8 or 10.

Any requested delay should be used with the in_kitchen prep stage.

Responses

Language

Credentials

OAuth2

URL

Loading…

Response

Choose an example:

application/json

200Everything worked as expected 🎉

400The request didn't work, often because a required parameter is missing or the content-type hasn't been set e.g. an incorrect JSON request

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.

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