Home›Search & Discovery›Nearby Restaurants

Nearby Restaurants

Find restaurants near a given geographic location. Returns a list of available providers sorted by proximity. The providerId and sellerId from this response are used in all subsequent restaurant and ordering calls.

Find Nearby Restaurants

GET /ret11/api/nearby-restaurants

Auth Required

Include a Bearer token. See Authentication.

Query Parameters

Parameter	Type	Required	Description
lat	number	required	Latitude of the user's current location. Example: `12.9716`
lng	number	required	Longitude of the user's current location. Example: `77.5946`
categoryIds	string	optional	Comma-separated category IDs to filter by cuisine/type. From fixed-categories. Example: `categoryIds=1,2,3`
vegFilter	string	optional	Filter by food type. Values: `"veg"` \| `"non_veg"`
costSort	string	optional	Sort results by cost. Values: `"LOW_TO_HIGH"` \| `"HIGH_TO_LOW"`
rating	number	optional	Minimum rating filter. Example: `4` returns only restaurants with rating ≥ 4
providerIds	string[]	optional	Filter to specific provider IDs only

City Auto-Detection

The city is automatically detected from lat and lng. If the coordinates fall outside a supported service area, the API returns a 400 error.

Example Request

GET /ret11/api/nearby-restaurants?lat=28.527300&lng=74.1821
GET /ret11/api/nearby-restaurants?lat=28.527300&lng=74.1821&vegFilter=veg&costSort=LOW_TO_HIGH&rating=4

Response

Returns an array of restaurant objects ordered by proximity.

Field	Type	Description
providerId	string	Unique restaurant/provider identifier. Save this — used in all subsequent calls.
sellerId	string	Seller UUID. Save this — used in all subsequent calls.
name	string	Display name of the restaurant
shortDesc	string	Short description
images	string[]	Array of image URLs
locality	string	Locality/neighborhood name
street	string	Street address
distance_m	number	Distance from the provided coordinates in meters

Response Example

[
  {
    "providerId": "pramaan_provider_1",
    "sellerId": "019b78d7-1371-7017-a997-3f6429a2f663",
    "name": "Pramaan Store 1",
    "shortDesc": "Pramaan Store 1",
    "images": [
      "https://pramaan.ondc.org/beta/preprod/mock/seller/assets/logo/store1.png"
    ],
    "locality": "N. Caldwell",
    "street": "633 Stagtrail Rd",
    "distance_m": 293629.0643862
  },
  {
    "providerId": "pramaan_provider_2",
    "sellerId": "019b78d7-1371-7017-a997-3f6429a2f663",
    "name": "Pramaan Store 2",
    "shortDesc": "Pramaan Store 2",
    "images": [],
    "locality": "N. Caldwell",
    "street": "634 Stagtrail Rd",
    "distance_m": 293629.0643862
  }
]

Next Steps

Use the providerId and sellerId from this response to:

Get restaurant details — hours, location, rating
Browse the restaurant menu
Add items to cart using these identifiers