---
title: "Read one place"
method: GET
path: "/places/{placeId}"
tags: ["Places"]
---

# Read one place

`GET /places/{placeId}`

## Request

- Base URL: `https://api.layout.link/v1`
- URL: `https://api.layout.link/v1/places/{placeId}`
- Auth: HTTP bearer

One place by the id a places, menu or order result gave you: the place, its dietary, service and good-for facts, and whether it can be ordered from. The same facts the MCP `place_facts` tool reads.

## Path parameters

- `placeId` string, required

## Query parameters

- `lat` number
- `lng` number

## Headers

- `Layout-Version` '2026-10-01'

## Response `200`

The place.

- PlaceDetail
  - `place` Place, required
    - `placeId` string, required
    - `slug` string, nullable, required: The public storefront path on layout.link.
    - `name` string, required
    - `address` string, nullable, required
    - `city` string, nullable, required
    - `region` string, nullable, required
    - `cuisine` string, nullable, required
    - `rating` number, nullable, required
    - `priceLevel` number, nullable, required: 1 (inexpensive) to 4 (very expensive). Null: not known.
    - `website` string, nullable, required
    - `openNow` boolean, nullable, required: Prefer `openStatus`: null here means not known, never closed.
    - `openStatus` 'open' | 'closed' | 'unknown', required: At the store's own clock. `unknown`: Layout holds no hours.
    - `ordering` 'confirmed' | 'unconfirmed' | 'unavailable', required: `confirmed`: Layout found an online ordering route. `unconfirmed`: not decided yet. `unavailable`: Layout looked and there is none.
    - `closesAt` string, nullable, required: Store-local closing time when open.
    - `opensAt` string, nullable, required: Store-local next opening when closed.
    - `closingSoon` boolean, required: Open, and closing within 45 minutes.
    - `distanceKm` number, nullable, required
    - `distanceMi` number, nullable, required: One decimal. Usually from the centre of `near` when it is sent and Layout can place it, else from `lat`/`lng`. Check `localityMatched`. Null without a location.
    - `photoUrl` string, nullable, required
  - `facts` PlaceFacts, required
    - `dietary` object, required
      - `vegetarian` boolean, nullable, required
      - `breakfast` boolean, nullable, required
      - `lunch` boolean, nullable, required
      - `dinner` boolean, nullable, required
      - `brunch` boolean, nullable, required
    - `service` object, required
      - `dineIn` boolean, nullable, required
      - `takeout` boolean, nullable, required
      - `delivery` boolean, nullable, required
      - `curbside` boolean, nullable, required
      - `reservable` boolean, nullable, required
    - `goodFor` object, required
      - `children` boolean, nullable, required
      - `groups` boolean, nullable, required
    - `asOf` string, required: When these facts were read.
  - `orderability` Orderability, required
    - `verdict` 'confirmed' | 'unconfirmed' | 'unavailable', required
    - `reason` 'no_online_ordering' | 'not_a_restaurant' | 'not_offered' | 'rechecking': Why, when the verdict is not `confirmed` and Layout knows.

## Other responses

- `400`: A parameter is out of range. `unsupported_version`: the Layout-Version header names no version this API answers.
- `401`: The token is missing, expired, revoked, issued for another audience, or the person disconnected. Every 401 reads the same.
- `403`: The credential is real and may not do this: an application or account that is suspended, a live person on an unapproved application, a scope the token was not granted, or a person whose Layout account cannot order yet.
- `404`: Layout holds no place with that id that can be shown.
- `429`: A per-minute brake, or this application's daily place reads.
- `500`: Layout failed to answer. Retry with backoff.
- `503`: Credentials or a dependency could not be checked right now. Retry with backoff.

---

[API](https://skmtc.dev/layout/apis/layout-partner-api.md) · [All operations](https://skmtc.dev/layout/apis/layout-partner-api/llms.txt) · [OpenAPI document](https://skmtc.dev/layout/apis/layout-partner-api/revisions/7ff4ba01bf56?raw)