> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tic.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Property search fields and examples

> Fields and examples for the property search collection behind /search-public/properties.

<Badge color="purple" size="sm">Max+ tier</Badge>

These are the fields of the `properties` search collection behind `/search-public/properties` ([GET](/api-lens/publicsearch/search-swedish-properties-get), [POST](/api-lens/publicsearch/search-swedish-properties-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](/api-lens/search), and the response schema on the endpoint pages.

Field guides for the other collections:

* [Companies](/api-lens/publicsearch/company-search-fields)
* [Workplaces](/api-lens/publicsearch/workplace-search-fields)
* [Financial reports](/api-lens/publicsearch/report-search-fields)
* [Bankruptcies](/api-lens/publicsearch/bankruptcy-search-fields)
* [Vehicles](/api-lens/publicsearch/vehicle-search-fields)
* **Properties (you are here)**

## Properties search

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.

| Field | Type | Description |
| - | - | - |
| id | String | The land registry's unique identifier for the property (UUID) |
| propertyDesignation | String | Property designation |
| propertyType | String/Enum | Can be of enum types fastighet or samfallighet |
| statusType | String/Enum | Can be of enum types levande or avregistrerad |
| buildingNames | String\[] | An array of strings containing known bulding names |
| buildingPurposes | String\[] | An array of string enums with the building purposes |
| buildingTypes | String\[] | An array of string enums with the building types |
| centroidArea1 | GeoPoint | The center latitude and longitude of the first area in the property |
| streetAddress | String | The street adress to the property |
| postalCode | Int32 | Postalcode to the property |
| city | String | The city where the property is located |
| countyCode | Int32 | The country code where the property is located |
| municipalityCode | String | The municipality code where the property is located |
| numberOfAddresses | Int32 | Number of addresses to the property |
| numberOfAreas | Int32 | Number of areas of the property |
| numberOfBuildings | Int32 | Number of buildings on the property |
| taxationCode | Int32 | The taxation code to the property |
| taxationValue | Int64 | The taxation value of the property in SEK |
| taxationYear | Int32 | The decision year of the taxation |
| totalArea | Float | The total area of the property |
| landArea | Float | The landarea in square meters of the property |
| waterArea | Float | The 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.

```bash cURL theme={null}
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
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.