Just Eat Order Webhooks API
The Order Webhooks API from Just Eat — 3 operation(s) for order webhooks.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/just-eat-order-webhooks-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
contact:
x-twitter: JustEatUK
description: '# Just Eat API
Just Eat offers services for our various business partners and our consumer applications.'
title: Just Eat UK Order Webhooks API
version: 1.0.0
x-apisguru-categories:
- ecommerce
x-logo:
url: https://api.apis.guru/v2/cache/logo/https_twitter.com_JustEatUK_profile_image.png
x-origin:
- format: openapi
url: https://uk.api.just-eat.io/docs/openapi.json
version: '3.0'
x-providerName: just-eat.co.uk
servers:
- description: Production URL for the UK API
url: https://uk.api.just-eat.io
- description: Production URL for the DK, ES, IE, IT and NO API
url: https://i18n.api.just-eat.io
- description: Production URL for the AU and NZ API
url: https://aus.api.just-eat.io
tags:
- name: Order Webhooks
paths:
/order-ready-for-preparation-async:
post:
description: 'This webhook will be invoked when we have determined that an order is ready for preparation. Upon receiving the request, you should perform any preparation-related activities, such as sending the order to the POS system / kitchen screen.
**NOTE:** This version of the webhook is asynchronous, and we expect a response in two parts:
1. We expect an immediate `202` response from this webhook to denote that you have received the request;
2. Following that, we expect an async callback - indicating either success or failure of the operation. The body for the async callbacks are as below:
**Success callback**
```
{
"status": "Success",
"message": "Order successfully sent to POS",
"data": {}
}
```
**Failure callback**
```
{
"status": "Failure",
"message": "{errorMessage}", // e.g. "The POS is currently in use"
"data": {}
}
```'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/order-ready-for-preparation'
required: true
responses:
'202':
description: Upon successful receipt of this event, a `202` status code should be returned, indicating the request has been accepted. You should then later respond with the result of processing this request, via the [callback URL](#section/Async-Webhooks) endpoint.
'400':
description: 'Should the initial validation of the order fail, return a `400` status code. NOTE: In this instance we do not also expect a failure callback via the async callback URL.'
summary: Order ready for preparation (async)
tags:
- Order Webhooks
operationId: postOrderReadyForPreparationAsync
x-operation-id-source: derived
/order-ready-for-preparation-sync:
post:
description: This webhook will be invoked when we have determined that an order is ready for preparation. Upon receiving the request, you should perform any preparation-related activities, such as sending the order to the POS system / kitchen screen.
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/order-ready-for-preparation'
required: true
responses:
'200':
description: Respond with a 200 status code to indicate that you have received the notification.
summary: Order ready for preparation (sync)
tags:
- Order Webhooks
operationId: postOrderReadyForPreparationSync
x-operation-id-source: derived
/send-to-pos-failed:
post:
description: 'This webhook will be invoked if we experience an error or timeout in sending an order to the underlying POS / kitchen screen. When notified via this webhook, typically you will perform some form of alerting or backup flow (e.g. ask the operator to enter the order manually into the POS). NOTE: This message contains the `OrderId`, but not the full order. It is assumed that you have stored/cached the full order details earlier in the flow - e.g. via the /order-ready-for-preparation webhook.'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/send-to-pos-failed'
required: true
responses:
'200':
description: Respond with a 200 status code to indicate that you have received the notification.
summary: Send to POS failed
tags:
- Order Webhooks
operationId: postSendToPosFailed
x-operation-id-source: derived
components:
schemas:
order-ready-for-preparation:
example:
Currency: GBP
Customer:
Id: Batman
Name: Bruce Wayne
CustomerNotes:
- Key: Floor
Value: 5th floor
- Key: Code
Value: Code 1234
Fulfilment:
Address:
City: London
Geolocation:
Latitude: 51.51641
Longitude: -0.103198
Lines:
- Fleet Place House
- Fleet Pl
PostalCode: EC4M 7RD
CustomerDueAsap: false
CustomerDueDate: '2018-03-10T14:45:28Z'
Method: Delivery
PhoneNumber: '+441234567890'
IsTest: true
Items:
- Items:
- Items: []
Name: Fries
Quantity: 1
Reference: '9876'
Synonym: Regular
UnitPrice: 0
- Items: []
Name: Pepsi
Quantity: 2
Reference: '6789'
Synonym: 330ml
UnitPrice: 0
Name: Chicken Box Meal
Quantity: 2
Reference: '1234'
Synonym: ''
TotalPrice: 10
UnitPrice: 5
- Items: []
Name: Milkshake
Quantity: 1
Reference: '4321'
Synonym: ''
TotalPrice: 7.25
UnitPrice: 7.25
OrderId: XYZ123456
Payment:
Lines:
- Paid: false
Type: card
Value: 19.25
PlacedDate: '2018-03-10T14:45:28Z'
PriceBreakdown:
Discount: 0
Fees:
Delivery: 1
Other: 0
ServiceCharge: 0.5
Items: 17.25
Taxes: 3.85
Tips: 0.5
Restaurant:
Address:
City: London
Geolocation:
Latitude: 51.4484
Longitude: -0.1504
Lines:
- Oldridge Road
PostalCode: SW12 8PW
Id: '99999'
Name: Just Eat Test Restaurant
PhoneNumber: '+441200000000'
Refererence: R99999
TotalPrice: 19.25
properties:
Currency:
type: string
Customer:
properties:
Id:
type: string
Name:
type: string
type: object
CustomerNotes:
additionalProperties:
type: string
type: object
Fulfilment:
properties:
Address:
properties:
City:
type: string
Geolocation:
$ref: '#/components/schemas/location'
Lines:
items:
type: string
type: array
PostalCode:
type: string
type: object
CustomerDueAsap:
type: boolean
CustomerDueDate:
format: date-time
type: string
Method:
enum:
- Delivery
- Collection
type: string
PhoneNumber:
type: string
PreparationTime:
format: timespan
type: string
PrepareFor:
format: date-time
type: string
type: object
IsTest:
type: boolean
Items:
items:
$ref: '#/components/schemas/item-v2'
type: array
OrderId:
type: string
Payment:
properties:
Lines:
items:
properties:
Paid:
type: boolean
Type:
enum:
- card
- cash
- credit
- other
type: string
Value:
format: money
type: number
type: object
type: array
type: object
PlacedDate:
format: date-time
type: string
PriceBreakdown:
properties:
Discount:
format: money
type: number
Fees:
properties:
Delivery:
format: money
type: number
Other:
format: money
type: number
ServiceCharge:
format: money
type: number
type: object
Items:
format: money
type: number
Taxes:
format: money
type: number
Tips:
format: money
type: number
type: object
Restaurant:
properties:
Address:
properties:
City:
type: string
Geolocation:
$ref: '#/components/schemas/location'
Lines:
items:
type: string
type: array
PostalCode:
type: string
type: object
Id:
type: string
Name:
type: string
PhoneNumber:
type: string
Reference:
type: string
type: object
TotalPrice:
format: money
type: number
type: object
item-v2:
properties:
Items:
items:
$ref: '#/components/schemas/item-v2'
type: array
Name:
type: string
Quantity:
type: integer
Reference:
type: string
UnitPrice:
format: money
type: integer
type: object
location:
description: GeoLocation object containing latitude and longitude values.
example:
Accuracy: 12.814
Heading: 357.10382
Latitude: 51.51641
Longitude: -0.103198
Speed: 8.68
properties:
Accuracy:
description: This should represent the accuracy of driver's location.
format: double
type: number
Heading:
description: This should represent the degree of heading direction, for example, 0 is north, 90 is east.
format: double
type: number
Latitude:
description: This should represent the latitude of the driver's location.
format: double
type: number
Longitude:
description: This should represent the longitude of the driver's location.
format: double
type: number
Speed:
description: This should represent the travel speed of the driver.
format: double
type: number
required:
- Latitude
- Longitude
type: object
send-to-pos-failed:
properties:
OrderId:
type: string
type: object
securitySchemes:
Bearer:
bearerFormat: JWT
description: Bearer token authentication using a JSON Web Token (JWT).
scheme: bearer
type: http
api_key:
description: APIs for delivery partners require an API key that will have been issued to you.
in: header
name: Authorization
type: apiKey
basic_auth:
description: A few services allow the use of basic authentication when a partner doesn't support OAuth based authentication.
scheme: basic
type: http
justeat_adfs:
description: ADFS authentication provider for internal Just Eat tools.
openIdConnectUrl: https://adfs.just-eat.com/adfs/.well-known/openid-configuration
type: openIdConnect
restaurantsignup_jwt:
bearerFormat: JWT token with payload `RestaurantId` and Role `[RestaurantRead | VerifyEmail | RestaurantWrite | FullAccess | DocumentRead]`
description: Bearer token authentication using a JSON Web Token (JWT), used by the restaurant sign up system
scheme: bearer
type: http
x-tagGroups:
- name: Consumer Experience
tags:
- Authorization
- Consumers
- ConsumerOffers
- ConsumerQueries
- Consumer Queries Webhooks
- ConsumerOrders
- Search
- Basket
- Payments
- Giftcards
- Experiments
- Vouchers
- Promoted Placement
- Menu
- Recommendations
- Location Services
- name: Manage Order Journey
tags:
- Order Acceptance API
- Order Acceptance Webhooks
- Order Delivery API
- Order Delivery Webhooks
- Order API
- Order Webhooks
- Customer Order Details
- DeliveryFee
- Delivery Pools API
- Attempted Delivery API
- Attempted Delivery Webhooks
- Checkout
- Courier Feedback
- name: Restaurant Management
tags:
- Restaurant Product
- Restaurants
- RestaurantOffers
- Restaurant OrderTimes
- Restaurants Webhooks
- RestaurantSignup
- RestaurantQueries
- RestaurantQueries Webhooks
- Restaurant Claims
- Restaurant Events
- Restaurant Events Webhooks
- Restaurant API
- Restaurant Webhooks
- Products
- Logistics POS Restaurants
- Restaurant Smiley Rating