Lessees

List all lessees

Retrieves the list of all lessees with pagination and filters

get/lessees

Request

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

Query parameters

searchstring

Free-text search over first name, last name, email and phone numbers.

emailstring

Exact match.

first_namestring

Partial match, case-insensitive.

last_namestring

Partial match, case-insensitive.

mobile_phonestring

Normalised before matching.

landline_phonestring

Normalised before matching.

categorystring

individual, company/other or guarantor.

citystring
postal_codestring
pageinteger

Zero-based page index. The first page is 0.

limitinteger

Rows per page. Defaults to 50.

sort_bystring

Field to sort on (created_at, last_name, email, …).

sort_order'asc' | 'desc'

Response

Lessee list retrieved successfully

totalinteger required

Total number of lessees

pageinteger required

Current page number

limitinteger required

Number of items per page

Example response

{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "category": "individual",
      "title": "M.",
      "first_name": "Jean",
      "last_name": "Dupont",
      "legal_name": "SARL Dupont & Associés",
      "birth_date": "1985-03-15",
      "birth_place": "Paris",
      "email": "jean.dupont@example.com",
      "mobile_phone": "+33 6 12 34 56 78",
      "landline_phone": "+33 1 23 45 67 89",
      "address_country": "France",
      "address_complement": "Appartement 12",
      "address_street_number": "123",
      "address_street_name": "rue de la Paix",
      "address_locality": "1er arrondissement",
      "address_postal_code": "75001",
      "address_city": "Paris",
      "address_postal_box": "123",
      "profession": "Ingénieur",
      "employer_name": "TechCorp SAS",
      "employer_phone": "+33 1 98 76 54 32",
      "monthly_income": 3500,
      "other_income": 500,
      "bank_name": "Crédit Agricole",
      "iban": "FR76 1234 5678 9012 3456 7890 123",
      "bic": "AGRIFRPP",
      "additional_addresses": {
        "work": "456 avenue des Champs-Élysées, 75008 Paris"
      },
      "identity_documents": {
        "passport": "12AB34567",
        "id_card": "123456789"
      },
      "additional_contacts": {
        "emergency": "+33 6 98 76 54 32",
        "family": "+33 1 11 22 33 44"
      },
      "custom_fields": {
        "preferred_language": "fr",
        "special_needs": "wheelchair access"
      },
      "auth_user_id": "user_123456789",
      "created_at": "2024-01-15T10:30:00Z",
      "updated_at": "2024-01-15T10:30:00Z"
    }
  ],
  "total": 10,
  "page": 1,
  "limit": 20
}

Changes

No recorded changes to this operation across all 1 revision of this API.