> ## Documentation Index
> Fetch the complete documentation index at: https://trailblazer.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /place-details/{place_id} — Restaurant details

> Fetch full details for a restaurant by Google Places place_id, including address, phone number, opening hours, photos, and real-time open/closed status.

The `/place-details/{place_id}` endpoint returns comprehensive information about a single restaurant from Google Places. You supply the `place_id` from a previous `/recommend` or `/places/top-picks` response, and the API returns the full record — address, phone number, website, current opening status, photo URLs, and GPS coordinates. This is the right endpoint to call when a user taps on a specific restaurant and you need to show them a detail view.

## Request

```text theme={null}
GET https://naijataste-api-vcp4.onrender.com/place-details/{place_id}
```

### Path parameters

<ParamField path="place_id" type="string" required>
  The Google Places `place_id` for the restaurant you want to look up (e.g. `"ChIJxxxxxxx"`). You can get this value from the `business_id` field in `/recommend` responses or the `place_id` field in `/places/top-picks` responses.
</ParamField>

## Response

<ResponseField name="name" type="string" required>
  The restaurant's full display name (e.g. `"Yellow Chilli Victoria Island"`).
</ResponseField>

<ResponseField name="address" type="string" required>
  The restaurant's street address (e.g. `"1234 Akin Adesola St, Victoria Island, Lagos"`).
</ResponseField>

<ResponseField name="phone" type="string">
  The restaurant's phone number in international format (e.g. `"+234 812 345 6789"`). May be `null` if not listed on Google Places.
</ResponseField>

<ResponseField name="rating" type="number" required>
  The Google Places average star rating (e.g. `4.2`).
</ResponseField>

<ResponseField name="total_ratings" type="number" required>
  The total number of Google Places reviews (e.g. `1823`).
</ResponseField>

<ResponseField name="price_level" type="number" required>
  A Google Places price level on a scale of 0–4, where `0` is free and `4` is very expensive.
</ResponseField>

<ResponseField name="website" type="string">
  The restaurant's website URL. May be `null` if not listed.
</ResponseField>

<ResponseField name="google_maps_url" type="string" required>
  A direct Google Maps link to this restaurant (e.g. `"https://maps.google.com/?cid=..."`).
</ResponseField>

<ResponseField name="photos" type="string[]" required>
  An array of Google Maps photo URLs for this restaurant. May be empty if no photos are available.
</ResponseField>

<ResponseField name="opening_hours" type="string[]" required>
  The restaurant's weekly opening hours, one string per day (e.g. `["Monday: 11:00 AM – 10:00 PM", "Tuesday: 11:00 AM – 10:00 PM"]`). May be empty if hours are not listed.
</ResponseField>

<ResponseField name="is_open_now" type="boolean" required>
  Whether the restaurant is currently open based on its listed hours and the current time.
</ResponseField>

<ResponseField name="lat" type="number" required>
  The latitude of the restaurant's location (e.g. `6.4281`).
</ResponseField>

<ResponseField name="lng" type="number" required>
  The longitude of the restaurant's location (e.g. `3.4219`).
</ResponseField>

## Example

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://naijataste-api-vcp4.onrender.com/place-details/ChIJxxxxxxx"
  ```

  ```json Response theme={null}
  {
    "name": "Yellow Chilli Victoria Island",
    "address": "1234 Akin Adesola St, Victoria Island, Lagos",
    "phone": "+234 812 345 6789",
    "rating": 4.2,
    "total_ratings": 1823,
    "price_level": 3,
    "website": "https://example.com",
    "google_maps_url": "https://maps.google.com/?cid=...",
    "photos": ["https://maps.googleapis.com/..."],
    "opening_hours": [
      "Monday: 11:00 AM – 10:00 PM",
      "Tuesday: 11:00 AM – 10:00 PM"
    ],
    "is_open_now": true,
    "lat": 6.4281,
    "lng": 3.4219
  }
  ```
</CodeGroup>

## Errors

| Status | Cause                                                                      |
| ------ | -------------------------------------------------------------------------- |
| `503`  | The Google Places API key is not configured or the service is unreachable. |
