---
title: "Get restaurants by postcode"
method: GET
path: "/restaurants/bypostcode/{postcode}"
tags: ["Restaurants", "publicly-accessible"]
---

# Get restaurants by postcode

`GET /restaurants/bypostcode/{postcode}`

Provides details of restaurants that deliver to the specified postcode

## Path parameters

- `postcode` string, required

## Query parameters

- `cuisine` string
- `restaurantName` string
- `brandName` string

## Headers

- `Authorization` string
- `Accept-Tenant` string

## Response `200`

OK

- union
  - SearchResponse
    - `CuisineSets` object[]
      - `Cuisines` object[]
        - `Name` string
        - `SeoName` string
      - `Id` string
      - `Name` string
      - `Type` string
    - `Dishes` object[]
      - `Best` object[]
        - `FullName` string — The full name of the product
        - `Price` number — The price of the product
        - `ProductId` number — Deprecated field no longer populated, but retained for backwards compatibility with clients
        - `StrProductId` string — The id of the product
      - `RestaurantId` number
      - `Similar` object[]
        - `FullName` string
        - `Price` number
        - `ProductId` number
    - `MetaData` object
      - `Area` string
      - `CanonicalName` string
      - `CuisineDetails` object[]
        - `Name` string
        - `SeoName` string
        - `Total` number
      - `District` string
      - `Latitude` number — The latitude of the search location
      - `Longitude` number — The longitude of the search location
      - `Postcode` string
      - `ResultCount` number
      - `SearchedTerms` object, nullable
      - `TagDetails` object[]
        - `BackgroundColour` string
        - `Colour` string
        - `DisplayName` string
        - `Key` string
        - `Priority` number
    - `RestaurantSets` object[]
      - `Id` string
      - `Name` string
      - `Restaurants` object[]
        - `Id` number
        - `Metadata` object[]
          - `Key` string
          - `Value` string
      - `Type` string
    - `Restaurants` SearchRestaurant[]
      - `Address` object
        - `City` string
        - `FirstLine` string
        - `Latitude` number
        - `Longitude` number
        - `Postcode` string
      - `Badges` object[]
      - `BrandName` string
      - `City` string
      - `CollectionMenuId` number, nullable
      - `CuisineTypes` object[]
        - `Id` number
        - `IsTopCuisine` boolean
      - `Cuisines` object[]
        - `Name` string
        - `SeoName` string
      - `Deals` object[]
        - `Description` string
        - `DiscountPercent` number
        - `OfferType` string
        - `QualifyingPrice` number
      - `DefaultDisplayRank` number
      - `DeliveryChargeBands` object[]
        - `BasketThresholdPrice` number
        - `DeliveryChargeBelowThreshold` number
      - `DeliveryCost` number
      - `DeliveryEtaMinutes` object
        - `Approximate` number, nullable
        - `RangeLower` number
        - `RangeUpper` number
      - `DeliveryMenuId` number
      - `DeliveryOpeningTime` string, date-time
      - `DeliveryOpeningTimeLocal` string — A local date time object, conforming to `ISO-8601`, but with only a partial time representation and no time offset.
      - `DeliveryOpeningTimeUtc` string, date-time, nullable
      - `DeliveryStartTime` string, date-time
      - `DeliveryTime` number, nullable
      - `DeliveryTimeMinutes` number, nullable
      - `DeliveryWorkingTimeMinutes` number
      - `DeliveryZipcode` string, nullable
      - `Description` string
      - `DriveDistance` number
      - `DriveInfoCalculated` boolean
      - `HygieneRating` number, nullable
      - `Id` number
      - `IsBrand` boolean
      - `IsCloseBy` boolean
      - `IsCollection` boolean
      - `IsDelivery` boolean
      - `IsFreeDelivery` boolean
      - `IsHalal` boolean
      - `IsNew` boolean
      - `IsOpenNow` boolean
      - `IsOpenNowForCollection` boolean
      - `IsOpenNowForDelivery` boolean
      - `IsOpenNowForPreorder` boolean
      - `IsPremier` boolean
      - `IsSponsored` boolean
      - `IsTemporarilyOffline` boolean
      - `IsTemporaryBoost` boolean
      - `IsTestRestaurant` boolean
      - `LastUpdated` string — A local date time object, conforming to `ISO-8601`, but with only a partial time representation and no time offset.
      - `Latitude` number
      - `Logo` object[]
        - `StandardResolutionURL` string
      - `LogoUrl` string
      - `Longitude` number
      - `MinimumDeliveryValue` number
      - `Name` string
      - `NewnessDate` string — A local date time object, conforming to `ISO-8601`, but with only a partial time representation and no time offset.
      - `NumberOfRatings` number
      - `OfferPercent` number
      - `Offers` object[]
      - `OpeningTime` string, date-time
      - `OpeningTimeIso` string — A local date time object, conforming to `ISO-8601`, but with only a partial time representation and no time offset.
      - `OpeningTimeLocal` string — A local date time object, conforming to `ISO-8601`, but with only a partial time representation and no time offset.
      - `OpeningTimeUtc` string, date-time, nullable
      - `OpeningTimes` object[]
      - `Postcode` string
      - `Rating` object
        - `Average` number
        - `Count` number
        - `StarRating` number
      - `RatingAverage` number
      - `RatingStars` number
      - `ReasonWhyTemporarilyOffline` string
      - `Score` number
      - `ScoreMetaData` object[]
        - `Key` string
        - `Value` string
      - `SecondDateRank` number
      - `SecondDateRanking` number
      - `SendsOnItsWayNotifications` boolean
      - `ServiceableAreas` object[]
      - `ShowSmiley` boolean
      - `SmileyDate` object, nullable
      - `SmileyElite` boolean
      - `SmileyResult` object, nullable
      - `SmileyUrl` object, nullable
      - `SponsoredPosition` number
      - `Tags` string[]
      - `UniqueName` string
      - `Url` string
    - `ShortResultText` string
    - `Views` object[]
      - `Components` object
        - `Id` string
        - `TemplateName` string
        - `TrackingId` string
        - `Type` string
        - `ViewData` object
      - `Target` string
    - `area` string
    - `deliveryFees` object — Information related to delivery fees.
      - `restaurants` object — Dictionary of `restaurantIds` to delivery fees.
    - `promotedPlacement` object — Information related to promoted placement restaurants.
      - `filteredSearchPromotedLimit` number — How many restaurants to promote when search is filtered
      - `rankedIds` number[] — Restaurants that can be promoted, in preferred order
      - `restaurants` object — Dictionary of `restaurantIds` to promoted placement info.
  - ExternalSearchResponse
    - `Restaurants` object[]
      - `Address` object
        - `City` string
        - `FirstLine` string
        - `Latitude` number
        - `Longitude` number
        - `Postcode` string
      - `DeliveryEtaMinutes` object
        - `Approximate` number
        - `RangeLower` number
        - `RangeUpper` number
      - `DriveDistance` number
      - `DriveInfoCalculated` boolean
      - `Id` number
      - `IsOpenNow` boolean
      - `IsOpenNowForDelivery` boolean
      - `Name` string
      - `UniqueName` string
      - `Url` string
  - SearchWebResponse
    - `Closed` SearchRestaurant[]
      - `Address` object
        - `City` string
        - `FirstLine` string
        - `Latitude` number
        - `Longitude` number
        - `Postcode` string
      - `Badges` object[]
      - `BrandName` string
      - `City` string
      - `CollectionMenuId` number, nullable
      - `CuisineTypes` object[]
        - `Id` number
        - `IsTopCuisine` boolean
      - `Cuisines` object[]
        - `Name` string
        - `SeoName` string
      - `Deals` object[]
        - `Description` string
        - `DiscountPercent` number
        - `OfferType` string
        - `QualifyingPrice` number
      - `DefaultDisplayRank` number
      - `DeliveryChargeBands` object[]
        - `BasketThresholdPrice` number
        - `DeliveryChargeBelowThreshold` number
      - `DeliveryCost` number
      - `DeliveryEtaMinutes` object
        - `Approximate` number, nullable
        - `RangeLower` number
        - `RangeUpper` number
      - `DeliveryMenuId` number
      - `DeliveryOpeningTime` string, date-time
      - `DeliveryOpeningTimeLocal` string — A local date time object, conforming to `ISO-8601`, but with only a partial time representation and no time offset.
      - `DeliveryOpeningTimeUtc` string, date-time, nullable
      - `DeliveryStartTime` string, date-time
      - `DeliveryTime` number, nullable
      - `DeliveryTimeMinutes` number, nullable
      - `DeliveryWorkingTimeMinutes` number
      - `DeliveryZipcode` string, nullable
      - `Description` string
      - `DriveDistance` number
      - `DriveInfoCalculated` boolean
      - `HygieneRating` number, nullable
      - `Id` number
      - `IsBrand` boolean
      - `IsCloseBy` boolean
      - `IsCollection` boolean
      - `IsDelivery` boolean
      - `IsFreeDelivery` boolean
      - `IsHalal` boolean
      - `IsNew` boolean
      - `IsOpenNow` boolean
      - `IsOpenNowForCollection` boolean
      - `IsOpenNowForDelivery` boolean
      - `IsOpenNowForPreorder` boolean
      - `IsPremier` boolean
      - `IsSponsored` boolean
      - `IsTemporarilyOffline` boolean
      - `IsTemporaryBoost` boolean
      - `IsTestRestaurant` boolean
      - `LastUpdated` string — A local date time object, conforming to `ISO-8601`, but with only a partial time representation and no time offset.
      - `Latitude` number
      - `Logo` object[]
        - `StandardResolutionURL` string
      - `LogoUrl` string
      - `Longitude` number
      - `MinimumDeliveryValue` number
      - `Name` string
      - `NewnessDate` string — A local date time object, conforming to `ISO-8601`, but with only a partial time representation and no time offset.
      - `NumberOfRatings` number
      - `OfferPercent` number
      - `Offers` object[]
      - `OpeningTime` string, date-time
      - `OpeningTimeIso` string — A local date time object, conforming to `ISO-8601`, but with only a partial time representation and no time offset.
      - `OpeningTimeLocal` string — A local date time object, conforming to `ISO-8601`, but with only a partial time representation and no time offset.
      - `OpeningTimeUtc` string, date-time, nullable
      - `OpeningTimes` object[]
      - `Postcode` string
      - `Rating` object
        - `Average` number
        - `Count` number
        - `StarRating` number
      - `RatingAverage` number
      - `RatingStars` number
      - `ReasonWhyTemporarilyOffline` string
      - `Score` number
      - `ScoreMetaData` object[]
        - `Key` string
        - `Value` string
      - `SecondDateRank` number
      - `SecondDateRanking` number
      - `SendsOnItsWayNotifications` boolean
      - `ServiceableAreas` object[]
      - `ShowSmiley` boolean
      - `SmileyDate` object, nullable
      - `SmileyElite` boolean
      - `SmileyResult` object, nullable
      - `SmileyUrl` object, nullable
      - `SponsoredPosition` number
      - `Tags` string[]
      - `UniqueName` string
      - `Url` string
    - `Offline` SearchRestaurant[]
      - `Address` object
        - `City` string
        - `FirstLine` string
        - `Latitude` number
        - `Longitude` number
        - `Postcode` string
      - `Badges` object[]
      - `BrandName` string
      - `City` string
      - `CollectionMenuId` number, nullable
      - `CuisineTypes` object[]
        - `Id` number
        - `IsTopCuisine` boolean
      - `Cuisines` object[]
        - `Name` string
        - `SeoName` string
      - `Deals` object[]
        - `Description` string
        - `DiscountPercent` number
        - `OfferType` string
        - `QualifyingPrice` number
      - `DefaultDisplayRank` number
      - `DeliveryChargeBands` object[]
        - `BasketThresholdPrice` number
        - `DeliveryChargeBelowThreshold` number
      - `DeliveryCost` number
      - `DeliveryEtaMinutes` object
        - `Approximate` number, nullable
        - `RangeLower` number
        - `RangeUpper` number
      - `DeliveryMenuId` number
      - `DeliveryOpeningTime` string, date-time
      - `DeliveryOpeningTimeLocal` string — A local date time object, conforming to `ISO-8601`, but with only a partial time representation and no time offset.
      - `DeliveryOpeningTimeUtc` string, date-time, nullable
      - `DeliveryStartTime` string, date-time
      - `DeliveryTime` number, nullable
      - `DeliveryTimeMinutes` number, nullable
      - `DeliveryWorkingTimeMinutes` number
      - `DeliveryZipcode` string, nullable
      - `Description` string
      - `DriveDistance` number
      - `DriveInfoCalculated` boolean
      - `HygieneRating` number, nullable
      - `Id` number
      - `IsBrand` boolean
      - `IsCloseBy` boolean
      - `IsCollection` boolean
      - `IsDelivery` boolean
      - `IsFreeDelivery` boolean
      - `IsHalal` boolean
      - `IsNew` boolean
      - `IsOpenNow` boolean
      - `IsOpenNowForCollection` boolean
      - `IsOpenNowForDelivery` boolean
      - `IsOpenNowForPreorder` boolean
      - `IsPremier` boolean
      - `IsSponsored` boolean
      - `IsTemporarilyOffline` boolean
      - `IsTemporaryBoost` boolean
      - `IsTestRestaurant` boolean
      - `LastUpdated` string — A local date time object, conforming to `ISO-8601`, but with only a partial time representation and no time offset.
      - `Latitude` number
      - `Logo` object[]
        - `StandardResolutionURL` string
      - `LogoUrl` string
      - `Longitude` number
      - `MinimumDeliveryValue` number
      - `Name` string
      - `NewnessDate` string — A local date time object, conforming to `ISO-8601`, but with only a partial time representation and no time offset.
      - `NumberOfRatings` number
      - `OfferPercent` number
      - `Offers` object[]
      - `OpeningTime` string, date-time
      - `OpeningTimeIso` string — A local date time object, conforming to `ISO-8601`, but with only a partial time representation and no time offset.
      - `OpeningTimeLocal` string — A local date time object, conforming to `ISO-8601`, but with only a partial time representation and no time offset.
      - `OpeningTimeUtc` string, date-time, nullable
      - `OpeningTimes` object[]
      - `Postcode` string
      - `Rating` object
        - `Average` number
        - `Count` number
        - `StarRating` number
      - `RatingAverage` number
      - `RatingStars` number
      - `ReasonWhyTemporarilyOffline` string
      - `Score` number
      - `ScoreMetaData` object[]
        - `Key` string
        - `Value` string
      - `SecondDateRank` number
      - `SecondDateRanking` number
      - `SendsOnItsWayNotifications` boolean
      - `ServiceableAreas` object[]
      - `ShowSmiley` boolean
      - `SmileyDate` object, nullable
      - `SmileyElite` boolean
      - `SmileyResult` object, nullable
      - `SmileyUrl` object, nullable
      - `SponsoredPosition` number
      - `Tags` string[]
      - `UniqueName` string
      - `Url` string
    - `Open` SearchRestaurant[]
      - `Address` object
        - `City` string
        - `FirstLine` string
        - `Latitude` number
        - `Longitude` number
        - `Postcode` string
      - `Badges` object[]
      - `BrandName` string
      - `City` string
      - `CollectionMenuId` number, nullable
      - `CuisineTypes` object[]
        - `Id` number
        - `IsTopCuisine` boolean
      - `Cuisines` object[]
        - `Name` string
        - `SeoName` string
      - `Deals` object[]
        - `Description` string
        - `DiscountPercent` number
        - `OfferType` string
        - `QualifyingPrice` number
      - `DefaultDisplayRank` number
      - `DeliveryChargeBands` object[]
        - `BasketThresholdPrice` number
        - `DeliveryChargeBelowThreshold` number
      - `DeliveryCost` number
      - `DeliveryEtaMinutes` object
        - `Approximate` number, nullable
        - `RangeLower` number
        - `RangeUpper` number
      - `DeliveryMenuId` number
      - `DeliveryOpeningTime` string, date-time
      - `DeliveryOpeningTimeLocal` string — A local date time object, conforming to `ISO-8601`, but with only a partial time representation and no time offset.
      - `DeliveryOpeningTimeUtc` string, date-time, nullable
      - `DeliveryStartTime` string, date-time
      - `DeliveryTime` number, nullable
      - `DeliveryTimeMinutes` number, nullable
      - `DeliveryWorkingTimeMinutes` number
      - `DeliveryZipcode` string, nullable
      - `Description` string
      - `DriveDistance` number
      - `DriveInfoCalculated` boolean
      - `HygieneRating` number, nullable
      - `Id` number
      - `IsBrand` boolean
      - `IsCloseBy` boolean
      - `IsCollection` boolean
      - `IsDelivery` boolean
      - `IsFreeDelivery` boolean
      - `IsHalal` boolean
      - `IsNew` boolean
      - `IsOpenNow` boolean
      - `IsOpenNowForCollection` boolean
      - `IsOpenNowForDelivery` boolean
      - `IsOpenNowForPreorder` boolean
      - `IsPremier` boolean
      - `IsSponsored` boolean
      - `IsTemporarilyOffline` boolean
      - `IsTemporaryBoost` boolean
      - `IsTestRestaurant` boolean
      - `LastUpdated` string — A local date time object, conforming to `ISO-8601`, but with only a partial time representation and no time offset.
      - `Latitude` number
      - `Logo` object[]
        - `StandardResolutionURL` string
      - `LogoUrl` string
      - `Longitude` number
      - `MinimumDeliveryValue` number
      - `Name` string
      - `NewnessDate` string — A local date time object, conforming to `ISO-8601`, but with only a partial time representation and no time offset.
      - `NumberOfRatings` number
      - `OfferPercent` number
      - `Offers` object[]
      - `OpeningTime` string, date-time
      - `OpeningTimeIso` string — A local date time object, conforming to `ISO-8601`, but with only a partial time representation and no time offset.
      - `OpeningTimeLocal` string — A local date time object, conforming to `ISO-8601`, but with only a partial time representation and no time offset.
      - `OpeningTimeUtc` string, date-time, nullable
      - `OpeningTimes` object[]
      - `Postcode` string
      - `Rating` object
        - `Average` number
        - `Count` number
        - `StarRating` number
      - `RatingAverage` number
      - `RatingStars` number
      - `ReasonWhyTemporarilyOffline` string
      - `Score` number
      - `ScoreMetaData` object[]
        - `Key` string
        - `Value` string
      - `SecondDateRank` number
      - `SecondDateRanking` number
      - `SendsOnItsWayNotifications` boolean
      - `ServiceableAreas` object[]
      - `ShowSmiley` boolean
      - `SmileyDate` object, nullable
      - `SmileyElite` boolean
      - `SmileyResult` object, nullable
      - `SmileyUrl` object, nullable
      - `SponsoredPosition` number
      - `Tags` string[]
      - `UniqueName` string
      - `Url` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Server Error

---

[API](https://skmtc.net/justeat/apis/just-eat.md) · [All operations](https://skmtc.net/justeat/apis/just-eat/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/justeat/just-eat/revisions/49ff8eb806d9/schema)