Sign in

v1

latestOpenAPI 3.0.02026-07-1498671635.3 KB
Restaurants
publicly-accessible

Get restaurants by postcode

Provides details of restaurants that deliver to the specified postcode

get/restaurants/bypostcode/{postcode}

Path parameters

postcodestring required

Filter search results to only include restaurants that deliver to the specified postcode

Query parameters

cuisinestring

Filter search results to only include restaurants that offer the specified cuisine

restaurantNamestring

Filter search results to only include restaurants that have a name that matches the specified value

brandNamestring

Filter search results to only include restaurants of the specified brand

Headers

Authorizationstring

OAuth2 token issued for logged in consumer or API key issued to partner

Accept-Tenantstring

A valid country code, e.g. "uk". Filter search results to only include restaurants for the specified country. Required when using OAuth for authentication.

Response

OK

OR
OR

Example response

{
  "Area": "Fleet Street",
  "CuisineSets": [
    {
      "Cuisines": [
        {
          "Name": "Pizza",
          "SeoName": "pizza"
        }
      ],
      "Id": "user_and_local_cuisines",
      "Name": "",
      "Type": "area_cuisines"
    }
  ],
  "Dishes": [],
  "MetaData": {
    "Area": "Fleet Street",
    "CanonicalName": "ec4-fleetstreet",
    "CuisineDetails": [
      {
        "Name": "Danish",
        "SeoName": "danish",
        "Total": 171
      }
    ],
    "District": "EC4",
    "Latitude": 0,
    "Longitude": 0,
    "Postcode": "EC4",
    "ResultCount": 1,
    "SearchedTerms": null,
    "TagDetails": [
      {
        "BackgroundColour": "#E6F6C5",
        "Colour": "#04822C",
        "DisplayName": "Tried and Tasted",
        "Key": "tried-and-tasted",
        "Priority": 300
      }
    ]
  },
  "RestaurantSets": [],
  "Restaurants": [
    {
      "Address": {
        "City": "London",
        "FirstLine": "London",
        "Latitude": 51.516454,
        "Longitude": -0.103137,
        "Postcode": "EC4M 7RF"
      },
      "Badges": [],
      "BrandName": "",
      "City": "London",
      "CollectionMenuId": null,
      "CuisineTypes": [
        {
          "Id": 2,
          "IsTopCuisine": false,
          "Name": "English",
          "SeoName": "english"
        }
      ],
      "Cuisines": [
        {
          "Name": "English",
          "SeoName": "english"
        }
      ],
      "Deals": [
        {
          "Description": "20% off when you spend £20",
          "DiscountPercent": 20,
          "OfferType": "Percent",
          "QualifyingPrice": 20
        }
      ],
      "DefaultDisplayRank": 0,
      "DeliveryChargeBands": [],
      "DeliveryCost": 0.12,
      "DeliveryEtaMinutes": {
        "Approximate": null,
        "RangeLower": 10,
        "RangeUpper": 25
      },
      "DeliveryMenuId": 224651,
      "DeliveryOpeningTime": "2019-11-18T01:00:00Z",
      "DeliveryOpeningTimeLocal": "2019-11-18T01:00:00",
      "DeliveryOpeningTimeUtc": null,
      "DeliveryStartTime": "2019-11-18T01:00:00Z",
      "DeliveryTime": null,
      "DeliveryTimeMinutes": null,
      "DeliveryWorkingTimeMinutes": 10,
      "DeliveryZipcode": null,
      "Description": "",
      "DriveDistance": 0,
      "DriveInfoCalculated": true,
      "HygieneRating": null,
      "Id": 102215,
      "IsBrand": false,
      "IsCloseBy": true,
      "IsCollection": false,
      "IsDelivery": true,
      "IsFreeDelivery": false,
      "IsHalal": false,
      "IsNew": false,
      "IsOpenNow": true,
      "IsOpenNowForCollection": false,
      "IsOpenNowForDelivery": true,
      "IsOpenNowForPreorder": false,
      "IsPremier": false,
      "IsSponsored": false,
      "IsTemporarilyOffline": false,
      "IsTemporaryBoost": false,
      "IsTestRestaurant": false,
      "LastUpdated": "2019-09-10T10:55:58.199397",
      "Latitude": 0,
      "Logo": [
        {
          "StandardResolutionURL": "http://d30v2pzvrfyzpo.cloudfront.net/uk/images/restaurants/102215.gif"
        }
      ],
      "LogoUrl": "http://d30v2pzvrfyzpo.cloudfront.net/uk/images/restaurants/102215.gif",
      "Longitude": 0,
      "MinimumDeliveryValue": 0,
      "Name": "TEST_DP_1",
      "NewnessDate": "2017-05-02T14:30:21",
      "NumberOfRatings": 0,
      "OfferPercent": 0,
      "Offers": [
        {
          "Amount": 20,
          "MaxQualifyingValue": 50,
          "OfferId": "136149",
          "QualifyingValue": 20,
          "Type": "Percent"
        }
      ],
      "OpeningTime": "2019-11-19T01:00:00Z",
      "OpeningTimeIso": "2019-11-19T01:00:00",
      "OpeningTimeLocal": "2019-11-19T01:00:00",
      "OpeningTimeUtc": null,
      "OpeningTimes": [],
      "Postcode": "EC4M 7RF",
      "Rating": {
        "Average": 0,
        "Count": 0,
        "StarRating": 0
      },
      "RatingAverage": 0,
      "RatingStars": 0,
      "ReasonWhyTemporarilyOffline": "",
      "Score": 502,
      "ScoreMetaData": [
        {
          "Key": "Distance",
          "Value": "0"
        },
        {
          "Key": "SetName",
          "Value": "Default"
        }
      ],
      "SecondDateRank": 0,
      "SecondDateRanking": 0,
      "SendsOnItsWayNotifications": false,
      "ServiceableAreas": [],
      "ShowSmiley": false,
      "SmileyDate": null,
      "SmileyElite": false,
      "SmileyResult": null,
      "SmileyUrl": null,
      "SponsoredPosition": 0,
      "Tags": [],
      "UniqueName": "test_dp-london-london",
      "Url": "https://www.just-eat.co.uk/restaurants-test_dp-london-london"
    }
  ],
  "ShortResultText": "EC4",
  "Views": [],
  "deliveryFees": {
    "restaurants": {
      "102215": {
        "bands": [
          {
            "fee": 100,
            "minimumAmount": 0
          }
        ],
        "minimumOrderValue": 0,
        "restaurantId": "102215"
      }
    }
  },
  "promotedPlacement": {
    "filteredSearchPromotedLimit": 5,
    "rankedIds": [
      84335
    ],
    "restaurants": {
      "84335": {
        "defaultPromoted": true,
        "restaurantId": "84335"
      }
    }
  }
}