Just Eat Delivery Pools API
The Delivery Pools API API from Just Eat — 5 operation(s) for delivery pools api.
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-delivery-pools-api-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 Delivery Pools 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: Delivery Pools API
paths:
/delivery/pools:
get:
description: A delivery pool is a named group of drivers which deliver food for a set of restaurants.
responses:
'200':
content:
application/json:
examples:
response:
value:
b9c6673b8e5948b98cfbd14a982de2c2:
name: Toronto - East
restaurants:
- 789
d5f72466a6dd49a08166d5a044c5b9e4:
name: Toronto - West
restaurants:
- 123
- 456
schema:
properties:
delivery-pool-id:
properties:
name:
description: The name of the pool, used by operations teams, in reports, etc.
type: string
restaurants:
description: A list of Just Eat restaurant ids served by the delivery pool.
items:
format: int32
type: number
type: array
type: object
type: object
description: OK
'500':
content:
text/plain:
examples:
response:
value: Internal Server Error
description: Internal Server Error
summary: Get your delivery pools
tags:
- Delivery Pools API
operationId: getDeliveryPools
x-operation-id-source: derived
post:
description: A delivery pool is a named group of drivers which deliver food for a set of restaurants.
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/create-delivery-pool'
required: true
responses:
'201':
description: Pool has been created.
'400':
content:
application/json:
examples:
response:
value:
name:
- '''Name'' should not be empty'
description: There was something invalid in your request - check response body for details
'500':
content:
text/plain:
examples:
response:
value: Internal Server Error
description: Internal Server Error
summary: Create a new delivery pool
tags:
- Delivery Pools API
operationId: postDeliveryPools
x-operation-id-source: derived
/delivery/pools/{deliveryPoolId}:
parameters:
- description: Identifier for the pool
in: path
name: deliveryPoolId
required: true
schema:
type: string
delete:
description: The restaurants will no longer be associated with the pool.
responses:
'200':
description: Pool deleted
'404':
description: The pool could not be found
'500':
content:
text/plain:
examples:
response:
value: Internal Server Error
description: Internal Server Error
summary: Delete a delivery pool
tags:
- Delivery Pools API
operationId: deleteDeliveryPoolsByDeliveryPoolId
x-operation-id-source: derived
get:
description: A delivery pool is a named group of drivers which deliver food for a set of restaurants.
responses:
'200':
content:
application/json:
examples:
response:
value:
name: Toronto - West
restaurants:
- 123
- 456
schema:
properties:
name:
description: The name of the pool, used by operations teams, in reports, etc.
type: string
restaurants:
description: A list of Just Eat restaurant ids served by the delivery pool.
items:
format: int32
type: number
type: array
type: object
description: OK
'404':
description: The pool could not be found
'500':
content:
text/plain:
examples:
response:
value: Internal Server Error
description: Internal Server Error
summary: Get an individual delivery pool
tags:
- Delivery Pools API
operationId: getDeliveryPoolsByDeliveryPoolId
x-operation-id-source: derived
patch:
description: Modify a delivery pool, changing its name, restaurants or both
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/patch-delivery-pool'
description: Request body should contain an object with either or both of the properties. If a property is not specified then the existing values are retained.
required: true
responses:
'202':
content:
application/json:
examples:
response:
value:
name: Toronto - North
restaurants:
- 123
- 456
schema:
properties:
name:
description: The name of the pool, used by operations teams, in reports, etc.
type: string
restaurants:
description: A list of Just Eat restaurant ids served by the delivery pool.
items:
format: int32
type: number
type: array
type: object
description: Pool has been updated
'400':
content:
application/json:
examples:
response:
value:
name:
- '''Name'' should not be empty'
description: There was something invalid in your request - check response body for details
'404':
description: The pool could not be found
'409':
content:
text/plain:
examples:
response:
value: 'Restaurant(s) are already assigned to pools : `{RestaurantId:55474, PoolId:cccebb96452349b799b71a7adc51df66}`'
description: A restaurant in your request already belongs to another pool
'500':
content:
text/plain:
examples:
response:
value: Internal Server Error
description: Internal Server Error
summary: Modify a delivery pool
tags:
- Delivery Pools API
operationId: patchDeliveryPoolsByDeliveryPoolId
x-operation-id-source: derived
put:
description: Replace an existing delivery pool changing all of its properties
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/create-delivery-pool'
required: true
responses:
'202':
content:
application/json:
examples:
response:
value:
name: Toronto - West
restaurants:
- 123
- 456
schema:
properties:
name:
description: The name of the pool, used by operations teams, in reports, etc.
type: string
restaurants:
description: A list of Just Eat restaurant ids served by the delivery pool.
items:
format: int32
type: number
type: array
type: object
description: Pool has been replaced
'400':
content:
application/json:
examples:
response:
value:
name:
- '''Name'' should not be empty'
description: There was something invalid in your request - check response body for details
'404':
description: The pool could not be found
'409':
content:
text/plain:
examples:
response:
value: 'Restaurant(s) are already assigned to pools : `{RestaurantId:55474, PoolId:cccebb96452349b799b71a7adc51df66}`'
description: A restaurant in your request already belongs to another pool
'500':
content:
text/plain:
examples:
response:
value: Internal Server Error
description: Internal Server Error
summary: Replace an existing delivery pool
tags:
- Delivery Pools API
operationId: putDeliveryPoolsByDeliveryPoolId
x-operation-id-source: derived
/delivery/pools/{deliveryPoolId}/availability/relative:
parameters:
- description: Identifier for the pool
in: path
name: deliveryPoolId
required: true
schema:
type: string
get:
description: Get the current amount of time it will take a driver to collect a new order from a restaurant in the pool.
responses:
'200':
content:
application/json:
examples:
request:
value:
bestGuess: 00:35:00
schema:
properties:
bestGuess:
description: Your best estimation (hh:mm:ss)
type: string
type: object
description: OK
'404':
description: The pool could not be found
summary: Get availability for pickup
tags:
- Delivery Pools API
operationId: getDeliveryPoolsByDeliveryPoolIdAvailabilityRelative
x-operation-id-source: derived
put:
description: Set the average amount of time it will take a driver to collect a new order from a restaurant in the pool.
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/estimated-time'
required: true
responses:
'202':
description: Update will take effect shortly
'404':
description: The pool could not be found
summary: Set availability for pickup
tags:
- Delivery Pools API
operationId: putDeliveryPoolsByDeliveryPoolIdAvailabilityRelative
x-operation-id-source: derived
/delivery/pools/{deliveryPoolId}/hours:
parameters:
- description: Identifier for the pool
in: path
name: deliveryPoolId
required: true
schema:
type: string
put:
description: Set the daily start and end times for a pool or set closed flag if the pool does not operate on that day. Start and end times for all days must be provided. Though the API accepts array of start and end times for each day, multiple start and end time for a day are not accepted. If the end time for a day is equal to or before start time, end time will be considered as time for the next day.
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/delivery-pool-hours'
required: true
responses:
'200':
description: Pool hours have been updated
'404':
description: The pool could not be found
summary: Set the delivery pools daily start and end times
tags:
- Delivery Pools API
operationId: putDeliveryPoolsByDeliveryPoolIdHours
x-operation-id-source: derived
/delivery/pools/{deliveryPoolId}/restaurants:
parameters:
- description: Identifier for the pool
in: path
name: deliveryPoolId
required: true
schema:
type: string
delete:
requestBody:
content:
application/json:
schema:
example:
restaurants:
- 123
- 456
properties:
restaurants:
description: A list of Just Eat restaurant ids served by the delivery pool.
items:
format: int32
type: number
type: array
type: object
required: true
responses:
'200':
description: Pool has been updated
'400':
description: There was something invalid in your request - check response body for details
'404':
description: The pool could not be found
summary: Remove restaurants from a delivery pool
tags:
- Delivery Pools API
operationId: deleteDeliveryPoolsByDeliveryPoolIdRestaurants
x-operation-id-source: derived
put:
description: Add additional restaurants to a delivery pool
responses:
'200':
content:
application/json:
examples:
response:
value:
restaurants:
- 123
- 456
schema:
$ref: '#/components/schemas/delivery-restaurantslist'
description: OK
'400':
description: There was something invalid in your request - check response body for details
'404':
description: The pool could not be found
'409':
description: The restaurants could not be added to the pool. Typically this is because they are already assigned to another pool
summary: Add restaurants to an existing delivery pool
tags:
- Delivery Pools API
operationId: putDeliveryPoolsByDeliveryPoolIdRestaurants
x-operation-id-source: derived
components:
schemas:
delivery-pool-hours:
example:
friday:
closed: false
poolTimes:
- endTime: 01:00
startTime: '12:00'
monday:
closed: false
poolTimes:
- endTime: '21:00'
startTime: 09:00
saturday:
closed: false
poolTimes:
- endTime: '23:00'
startTime: '11:00'
sunday:
closed: false
poolTimes:
- endTime: '19:00'
startTime: '13:00'
thursday:
closed: false
poolTimes:
- endTime: 03:00
startTime: '12:00'
tuesday:
closed: true
poolTimes:
- endTime: '19:00'
startTime: '10:00'
wednesday:
closed: false
poolTimes:
- endTime: '18:00'
startTime: 08:00
properties:
friday:
properties:
closed:
description: true if the pool is closed for the day
type: boolean
poolTimes:
description: pool start and end times for the day
items:
properties:
endTime:
description: pool end time for Friday (HH:mm)
type: string
startTime:
description: pool start time for Friday (HH:mm)
type: string
required:
- startTime
- endTime
type: object
type: array
required:
- poolTimes
type: object
monday:
properties:
closed:
description: true if the pool is closed for the day
type: boolean
poolTimes:
description: pool start and end times for the day
items:
properties:
endTime:
description: pool end time for Monday (HH:mm)
type: string
startTime:
description: pool start time for Monday (HH:mm)
type: string
required:
- startTime
- endTime
type: object
type: array
required:
- poolTimes
type: object
saturday:
properties:
closed:
description: true if the pool is closed for the day
type: boolean
poolTimes:
description: pool start and end times for the day
items:
properties:
endTime:
description: pool end time for Saturday (HH:mm)
type: string
startTime:
description: pool start time for Saturday (HH:mm)
type: string
required:
- startTime
- endTime
type: object
type: array
required:
- poolTimes
type: object
sunday:
properties:
closed:
description: true if the pool is closed for the day
type: boolean
poolTimes:
description: pool start and end times for the day
items:
properties:
endTime:
description: pool end time for Sunday (HH:mm)
type: string
startTime:
description: pool start time for Sunday (HH:mm)
type: string
required:
- startTime
- endTime
type: object
type: array
required:
- poolTimes
type: object
thursday:
properties:
closed:
description: true if the pool is closed for the day
type: boolean
poolTimes:
description: pool start and end times for the day
items:
properties:
endTime:
description: pool end time for Thursday (HH:mm)
type: string
startTime:
description: pool start time for Thursday (HH:mm)
type: string
required:
- startTime
- endTime
type: object
type: array
required:
- poolTimes
type: object
tuesday:
properties:
closed:
description: true if the pool is closed for the day
type: boolean
poolTimes:
description: pool start and end times for the day
items:
properties:
endTime:
description: pool end time for Tuesday (HH:mm)
type: string
startTime:
description: pool start time for Tuesday (HH:mm)
type: string
required:
- startTime
- endTime
type: object
type: array
required:
- poolTimes
type: object
wednesday:
properties:
closed:
description: true if the pool is closed for the day
type: boolean
poolTimes:
description: pool start and end times for the day
items:
properties:
endTime:
description: pool end time for Wednesday (HH:mm)
type: string
startTime:
description: pool start time for Wednesday (HH:mm)
type: string
required:
- startTime
- endTime
type: object
type: array
required:
- poolTimes
type: object
required:
- monday
- tuesday
- wednesday
- thursday
- friday
- saturday
- sunday
type: object
patch-delivery-pool:
example:
name: Toronto - North
properties:
name:
description: The name of the pool, used by operations teams, in reports, etc.
type: string
restaurants:
description: A list of Just Eat restaurant ids served by the delivery pool.
items:
format: int32
type: number
type: array
type: object
delivery-restaurantslist:
properties:
restaurants:
description: A list of Just Eat restaurant ids served by the pool.
example:
- 10202
- 10203
items:
format: int32
type: number
type: array
type: object
create-delivery-pool:
example:
name: Toronto - West
restaurants:
- 123
- 456
properties:
name:
description: The name of the pool, used by operations teams, in reports, etc.
type: string
restaurants:
description: A list of Just Eat restaurant ids served by the delivery pool.
items:
format: int32
type: number
type: array
required:
- name
type: object
estimated-time:
example:
bestGuess: 00:35:00
properties:
bestGuess:
description: Your best estimation (hh:mm:ss)
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