Property Portfolio

Lean's Property Portfolio enables businesses to retrieve the properties associated with a customer in KSA.

By returning a customer's property portfolio, businesses can simplify lending, onboarding, and property-related workflows without relying on manual document collection.

Looking for endpoint details? See the Property Portfolio API Reference.

When to use Property Portfolio

Use Property Portfolio when you need to:

Retrieve a customer's properties
Support secured lending
Identify potential collateral
Streamline customer onboarding
Build property-enabled financial experiences

Common use cases

Use Case	How Property Portfolio Helps
Mortgage applications	Retrieve the applicant's properties
Secured Lending	Identify properties that may be used as collateral
Customer Onboarding	Remove the need for manual property declarations
Wealth Management	Build a customer's property profile

How it Works

Property Portfolio retrieves the properties associated with a customer using the supported customer identifiers:
ID Number + Date of Birth

Provide an identification_method of IDENTITY and an
identifications array containing the owner identification and the owner's date of birth:
When the owner identification is NATIONAL_ID, provide DATE_OF_BIRTH_HIJRI.
For any other owner identification, provide DATE_OF_BIRTH_GREGORIAN.

Depending on the customer's records, the API may return:

One property
Multiple properties
No matching properties

Example Response for Property Portfolio

{
  "status": "OK",
  "results_id": "d2d95011-f834-4979-83eb-9c35b95f093c",
  "message": "Data successfully retrieved",
  "timestamp": "2026-03-25T11:01:04.709087696Z",
  "verifications": [
    {
      "status": "ACTIVE",
      "general_information": {
        "property_number": "6535007960400000",
        "first_registration_date": {
          "gregorian": "2025-01-28",
          "hijri": "1446-07-28"
        },
        "ownership_date": {
          "gregorian": null,
          "hijri": "1446-07-28"
        }
      },
      "spatial": {
        "area_size": 441.9901,
        "property_use": "RESIDENTIAL",
        "property_use_code": 2,
        "property_type_name": null,
        "property_status": null
      },
      "address": {
        "city_name": {
          "en": "Riyadh",
          "ar": "الرياض"
        },
        "district_name": {
          "en": "AL-JANADRIYAH",
          "ar": "الجنادرية"
        },
        "district_code": "001022175"
      },
      "owner_share_percentage": "100.000 %"
    },
    {
      "status": "ACTIVE",
      "general_information": {
        "property_number": "7660081406600000",
        "first_registration_date": {
          "gregorian": "2026-01-25",
          "hijri": "1447-08-06"
        },
        "ownership_date": {
          "gregorian": null,
          "hijri": "1447-08-06"
        }
      },
      "spatial": {
        "area_size": 600,
        "property_use": "MIXED_USE",
        "property_use_code": 11,
        "property_type_name": {
          "en": "Residential Apartment",
          "ar": "شقة سكنية"
        },
        "property_status": "BUILDING"
      },
      "address": {
        "city_name": {
          "en": "Riyadh",
          "ar": "الرياض"
        },
        "district_name": {
          "en": "TWAEEQ",
          "ar": "طويق"
        },
        "district_code": "001022163"
      },
      "owner_share_percentage": "4.000 %"
    }
  ],
  "page": {
    "number": 0,
    "size": 20,
    "total_elements": 2,
    "total_pages": 1
  }
}