---
title: "List Places"
method: GET
path: "/api/v1/places"
tags: ["places"]
---

# List Places

`GET /api/v1/places`

## Request

- Base URL: `https://yondry.app` (the document declares no server; this is the origin it was published from)
- URL: `https://yondry.app/api/v1/places`
- Auth: HTTP bearer

## Query parameters

- `tag` string, nullable
- `place_type` 'park' | 'playground' | 'museum' | 'cafe' | 'restaurant' | 'bar' | 'activity' | 'shopping' | 'other'
- `status` 'pending' | 'active' | 'closed'
- `is_favourite` boolean, nullable
- `city` string, nullable
- `search` string, nullable
- `near_lat` number, nullable
- `near_lon` number, nullable
- `radius_km` number, nullable
- `limit` integer
- `offset` integer

## Response `200`

Successful Response

- ListResponsePlaceListItem
  - `data` PlaceListItem[], required
    - `id` string, uuid, required
    - `name` string, required
    - `address` string, nullable, required
    - `lat` number, nullable, required
    - `lon` number, nullable, required
    - `city` string, nullable, required
    - `country_code` string, nullable, required
    - `place_type` 'park' | 'playground' | 'museum' | 'cafe' | 'restaurant' | 'bar' | 'activity' | 'shopping' | 'other', required
    - `category` string, nullable, required
    - `price_level` integer, nullable, required
    - `rating` number, nullable, required
    - `photos` string[], required
    - `photo_url` string, nullable
    - `is_favourite` boolean, required
    - `status` 'pending' | 'active' | 'closed', required
    - `permanently_closed` boolean, required
    - `source_type` 'manual' | 'google_import' | 'url_import' | 'screenshot' | 'social_save', required
    - `source` string, required
    - `user_rating` integer, nullable, required
    - `user_tags` string[], required
    - `tags` string[], required
    - `saved_at` string, date-time, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `deleted_at` string, date-time, nullable, required
    - `is_deleted` boolean, required
    - `stroller_friendly` boolean, nullable
    - `has_changing_facilities` boolean, nullable
    - `noise_level` string, nullable
    - `is_open_now` boolean, nullable
    - `visit_count` integer
    - `distance_km` number, nullable
  - `meta` ListMeta, required: Envelope metadata included with every list response.
    - `total` integer, required
    - `updated_at` string, date-time, nullable

## Other responses

- `422`: Validation Error

---

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