TIC
Max+ tier

These are the fields of the properties search collection behind /search-public/properties (GET, POST). Use them in query_by, filter_by and sort_by. The parameters, plan limits, Pro tier filtering, redacted properties and date handling that apply to every collection are described in Search, and the response schema on the endpoint pages.

Field guides for the other collections:

With our search for properties you can query (query_by) based on a number fields listed in the next chapter.

Examples on what you can query on:

  • Street
  • City
  • Postalcode
  • Type of property

Fields indexed

The following fields are currently indexed in memory. These can be used in the query_by and filter_by parameter.

FieldTypeDescription
idstringThe land registry's unique identifier for the property (UUID)
propertyDesignationstringProperty designation
propertyTypestring/enumCan be of enum types fastighet or samfallighet
statusTypestring/enumCan be of enum types levande or avregistrerad
buildingNamesstring[]An array of strings containing known bulding names
buildingPurposesstring[]An array of string enums with the building purposes
buildingTypesstring[]An array of string enums with the building types
centroidArea1geopointThe center latitude and longitude of the first area in the property
streetAddressstringThe street adress to the property
postalCodeint32Postalcode to the property
citystringThe city where the property is located
countyCodeint32The country code where the property is located
municipalityCodestringThe municipality code where the property is located
numberOfAddressesint32Number of addresses to the property
numberOfAreasint32Number of areas of the property
numberOfBuildingsint32Number of buildings on the property
taxationCodeint32The taxation code to the property
taxationValueint64The taxation value of the property in SEK
taxationYearint32The decision year of the taxation
totalAreafloatThe total area of the property
landAreafloatThe landarea in square meters of the property
waterAreafloatThe water area of the property

Examples

We have put together a few example of how you can use search for workplaces to easy find data.

Search for properties with taxation code 220

Shows an example searching for properties with taxation code 220, house.

cURLbash
curl -H "x-api-key: YOUR_API_KEY" \
  "https://lens-api.tic.io/search-public/properties?q=*&query_by=*&filter_by=taxationCode:=220"
{
    "facet_counts": [],
    "found": 2257868,
    "hits": [
        {
            "document": {
                "buildingPurposes": [
                    "Smahuskedjehus"
                ],
                "buildingTypes": [
                    "Komplementbyggnad",
                    "Komplementbyggnad",
                    "Bostad"
                ],
                "centroidArea1": [
                    59.1234,
                    13.1234
                ],
                "city": "Hammarö",
                "countyCode": 17,
                "id": "000a6a6f-ea7e-90ec-e040-ed8f66444c13",
                "landArea": 578.0,
                "municipalityCode": 61,
                "numberOfAddresses": 1,
                "numberOfAreas": 1,
                "numberOfBuildings": 3,
                "postalCode": 66340,
                "propertyDesignation": "STADEN ÖN 1:123",
                "streetAddress": "Testvagen 1",
                "taxationCode": 220,
                "taxationValue": 3081000,
                "taxationYear": 2024,
                "totalArea": 578.0,
                "waterArea": 0.0
            },
            "highlight": {},
            "highlights": []
        }
	],
    "out_of": 5056630,
    "page": 1,
    "request_params": {
        "collection_name": "properties_se_20250531192417",
        "first_q": "*",
        "per_page": 10,
        "q": "*"
    },
    "search_cutoff": false,
    "search_time_ms": 73
}