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

# List places

`GET /places`

## Request

- Base URL: `https://api.faireplace.com/api`
- URL: `https://api.faireplace.com/api/places`
- Auth: HTTP bearer

## Query parameters

- `search` string
- `name` string
- `address` string
- `ban_id` string
- `city` string
- `postal_code` string
- `country` string
- `place_type_id` string, uuid
- `owner_id` string, uuid
- `created_after` string, date
- `created_before` string, date
- `page` integer
- `limit` integer
- `sort_by` string
- `sort_order` 'asc' | 'desc'

## Response `200`

OK

- Place[]
  - `id` string, uuid, nullable
  - `name` string, nullable
  - `country` string, nullable
  - `address_complement` string, nullable
  - `street_number` string, nullable
  - `street_name` string, nullable
  - `locality` string, nullable
  - `postal_code` string, nullable
  - `city` string, nullable
  - `postal_box` string, nullable
  - `latitude` number, nullable
  - `longitude` number, nullable
  - `description` string, nullable
  - `type_id` string, uuid, nullable
  - `country_id` string, uuid, nullable
  - `digicode` string, nullable
  - `number_of_floor` integer, nullable
  - `owner_id` string, uuid, nullable
  - `previous_owner_id` string, uuid, nullable
  - `construction_date` string, date-time, nullable
  - `renovation_date` string, date-time, nullable
  - `place_category` 'Individual' | 'Collective': Place category (individual or collective)
  - `legal_regime` 'MonoPropriete' | 'Copropriete': Legal regime of the place
  - `created_at` string, date-time, nullable
  - `updated_at` string, date-time, nullable

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `500`: Internal Server Error

---

[API](https://skmtc.dev/faireplace/apis/faireplace-property-management-api.md) · [All operations](https://skmtc.dev/faireplace/apis/faireplace-property-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/faireplace/apis/faireplace-property-management-api/revisions/69de39762919?raw)