---
title: "List all lessees"
method: GET
path: "/lessees"
tags: ["Lessees"]
---

# List all lessees

`GET /lessees`

## Request

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

Retrieves the list of all lessees with pagination and filters

## Query parameters

- `search` string
- `email` string
- `first_name` string
- `last_name` string
- `mobile_phone` string
- `landline_phone` string
- `category` string
- `city` string
- `postal_code` string
- `page` integer
- `limit` integer
- `sort_by` string
- `sort_order` 'asc' | 'desc'

## Response `200`

Lessee list retrieved successfully

- LesseeListResponse: Paginated response for the lessee list
  - `data` Lessee[], required: Lessees list
    - `id` string, uuid, required: Unique identifier of the lessee
    - `category` 'individual' | 'company/other' | 'guarantor', required: Lessee category
    - `title` string: Title (Mr., Mrs., etc.)
    - `first_name` string: First name
    - `last_name` string: Last name
    - `legal_name` string: Legal name (for companies)
    - `birth_date` string, date, nullable: Date of birth
    - `birth_place` string: Place of birth
    - `email` string, email: Email address
    - `mobile_phone` string: Mobile phone number
    - `landline_phone` string: Landline phone number
    - `address_country` string: Country
    - `address_complement` string: Address complement
    - `address_street_number` string: Street number
    - `address_street_name` string: Street name
    - `address_locality` string: Locality, district, or borough
    - `address_postal_code` string: Postal code
    - `address_city` string: City
    - `address_postal_box` string: PO Box
    - `profession` string: Profession
    - `employer_name` string: Employer name
    - `employer_phone` string: Employer phone
    - `monthly_income` number, nullable: Monthly income
    - `other_income` number, nullable: Other income
    - `bank_name` string: Bank name
    - `iban` string: IBAN code
    - `bic` string: BIC/SWIFT code
    - `additional_addresses` object, nullable: Additional addresses (JSON)
    - `identity_documents` object, nullable: Identity documents (JSON)
    - `additional_contacts` object, nullable: Additional contacts (JSON)
    - `custom_fields` object, nullable: Custom fields (JSON)
    - `auth_user_id` string, nullable: Better Auth user ID
    - `created_at` string, date-time, required: Creation date
    - `updated_at` string, date-time, required: Last modification date
  - `total` integer, required: Total number of lessees
  - `page` integer, required: Current page number
  - `limit` integer, required: Number of items per page

## 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)