> ## 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.

# Search properties

> Search Swedish properties (fastigheter) by address, region, owner, and property classification — sourced from Lantmäteriet.

With our search for properties you can search for properties based on street, city, postalcode, municipality, county, area,
type of property and much more.

We provide an easy to use search API based on [Typesense](https://typesense.org) lightning-fast search database.
That means that all features described in [Typesense API version 29](https://typesense.org/docs/29.0/api/) is available in our API.
Data is continuously reindexed as new data arrives.

We today provide six rich search collections:

* **Properties search (you are here)**
* [Company search](/search)
* [Company workplaces search](/search-workplaces)
* [Financial reports search](/datasets/search-reports-se)
* [Bankruptcies](/datasets/search-bankruptcies-se)
* [Vehicles](/datasets/search-vehicles)

## 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

The response model (schema) depends on your query and if you use faceting. If you
do plain search we have added to our OpenAPI Schema the default response
model.

<Card title="OpenAPI Schema" icon="link" href="https://api.tic.io/docs/v1/swagger.json">
  Look for the model name TypesenseLantmaterietFastighetDocument in the schema
  definition.
</Card>

## 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      | Lantmäteriets unique identifier for the property (UUID)             |
| propertyDesignation | String      | Property designation (Swedish: Fastighetsbeteckning)                |
| 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 (Swedish: Småhusenhet, bebyggd)

Shows an example searching for properties with taxation code 220, house (Swedish: Småhusenhet, bebyggd).

```bash cURL theme={null}
curl https://api.tic.io/search/properties/se?q=*&query_by=*&filter_by=taxationCode:=220&key=your_api_key
{
    "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
}
```
