---
title: "List Japan Places"
method: GET
path: "/japan/places"
tags: ["japan"]
---

# List Japan Places

`GET /japan/places`

List Japan tourism resources, eager-loading photos.

The FE issues this twice today: `?rank=SA,A` server-side for SSR
(powers the JSON-LD schema and the initial map render) and `?rank=B`
client-side when the user toggles the B-tier filter on.

## Query parameters

- `rank` string, nullable — Comma-separated tiers, e.g. ?rank=SA,A. Omit to fetch all.

## Response `200`

Successful Response

- JapanPlacesListResponse — Wrapped in `points` to match the legacy JSON file shape exactly — `placesData.points` keeps working in the FE without unwrap logic.
  - `points` JapanPlaceResponse[], required
    - `id` string, required
    - `name` string, required
    - `name_kana` string, nullable
    - `en_name` string, required
    - `rank` 'SA' | 'A' | 'B', required
    - `type` string, required
    - `prefecture` string, required
    - `city` string, required
    - `lat` number, required
    - `lng` number, required
    - `tagline` string, required
    - `description` string, required
    - `url` string, required
    - `photos` PhotoResponse[], required
      - `url` string, required
      - `attribution` PhotoAttributionResponse
        - `displayName` string, required
        - `uri` string, nullable
    - `google_maps_url` string, nullable
    - `similar_ids` string[], nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/stardrift/apis/fastapi.md) · [All operations](https://skmtc.dev/stardrift/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/stardrift/fastapi/revisions/00746572572a/schema)