Properties
This endpoint is not generally available. For questions please contact sales.
GET /properties HTTP/2
The properties endpoint returns a list of properties. You can filter the list by various criteria.
Example use-cases:
- Display a list of properties in your application.
- Allow navigation to the details of a property.
Request
curl -X GET 'https://quis.de/api/v2/properties?api_key=<YOUR-API-KEY>'
| Field | Description | Type | Remarks | 
|---|---|---|---|
| limit | Maximum number of items to return | integer | max: 100, default: 10 | 
| offset | Number of items to skip | integer | default: 0 | 
| parentId | Filter by the parent property group | string | If left empty only properties without a parent are listed. Except when a query is provided. | 
| query | Filter the properties | string | Filtered by customId,externalId,address, etc. | 
Response
{
  "items": [
    {
      "id": "aee52a8c-6a50-4e3f-b5bd-6aecd2d4abbd",
      "customId": "123456789",
      "externalId": "e29266df-6501-4326-a7e1-9440d347f8df",
      "parentId": "9b4f4f58-92bb-4ea3-b623-53b2141a17de",
      "location": {
        "address": {
          "unstructured": "Musterstraße 1, 12345 Musterstadt"
        },
        "coordinates": {
          "latitude": 52.520008,
          "longitude": 13.404954
        }
      },
      "propertyType": {
        "type": "apartment",
        "subtype": "apartment_apartment"
      },
      "buildingYear": 1990,
      "livingArea": 100.5,
      "landArea": 100.5,
      "numberOfRooms": 3,
      "floor": 1,
      "currentRent": 1025.5,
      "rentControl": false,
      "condition": "moderate",
      "quality": "upscale",
      "energyCertificate": {
        "type": "consumption",
        "value": 89.75
      },
      "primaryEnergySource": "gas",
      "heatingTypes": [
        "gas",
        "floor"
      ],
      "equipments": [
        "balcony",
        "lift",
        "kitchen",
        "Sauna"
      ]
    },
    ...
  ],
  "totalItems": 15364,
  "meta": {
    "url": null,
    "version": "2.15.0"
  }
}