---
title: "Liste les baux des biens accessibles au compte authentifié."
method: GET
path: "/api/v1/tenants"
tags: ["tenants"]
---

# Liste les baux des biens accessibles au compte authentifié.

`GET /api/v1/tenants`

## Request

- Base URL: `https://api.qalimo.fr`
- URL: `https://api.qalimo.fr/api/v1/tenants`
- Auth: HTTP bearer

Seuls les baux actifs sont renvoyés, sauf indication contraire via le
filtre `status`. Le filtre `property_id` restreint aux baux d'un bien.

## Query parameters

- `status` string[]
- `property_id` integer, nullable

## Response `200`

OK

- TenantSummary[]
  - `id` integer, required: Identifiant du bail.
  - `name` string, required: Libellé du bail.
  - `occupants` string, required: Nom d'affichage des occupants.
  - `property_id` integer, required: Identifiant du bien loué.
  - `start_date` string, date, required: Date de début du bail.
  - `end_date` string, date, nullable: Date de fin du bail (null si non renseignée).
  - `rent_excluding_charges` number, nullable: Loyer hors charges, complément de loyer inclus.
  - `status` 'active' | 'candidate' | 'archived' | 'archived_candidate', required: État du bail (actif, candidat, archivé, candidat archivé).

## Other responses

- `422`: Unprocessable Content
- `default`: Default error response

---

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