# Get types (v1)

> **Casafari is the AI agent-native real estate data intelligence platform.** The most complete property index in Europe: a deduplicated, cleaned property graph of residential and commercial property, for sale and for rent, in 16 countries. Every property is one record with its full price and market history. [How the property graph is built](/docs/property-graph).

`GET https://api.casafari.com/api/v1/references/types`

[References](/docs/references) · [REST API](/docs/rest/references). Send `Authorization: Bearer $CASAFARI_TOKEN`; see [how to get a token](/docs/rest#get-a-token).

Over MCP: no tool does this. See [MCP and REST compared](/docs/parity#references).

## Description

Returns a list of all possible estate types.

## Example request

Placeholders only: replace the token and the values with your own.

```bash
curl "https://api.casafari.com/api/v1/references/types" \
  -H "Authorization: Bearer $CASAFARI_TOKEN"
```

## Responses

### 200 OK

Type: `object[]`.

- `types` (object[], required): List of grouped property types.
  - `group` (string, required): Name of the group of types.
  - `names` (string[], required): List of type names that belong to a specific group.
- `types_with_countries` (object[], required): List of type names with countries where each type is available.
  - `name` (string, required): Type name.
  - `countries` (string[], required): List of countries where the type is available.

Example from the API description (long arrays shortened):

```json
{
  "types": [
    {
      "group": "apartment",
      "names": [
        "apartment",
        "studio"
      ]
    },
    {
      "group": "house",
      "names": [
        "country_house",
        "house"
      ]
    }
  ],
  "types_with_countries": [
    {
      "name": "apartment",
      "countries": [
        "Portugal",
        "Spain"
      ]
    },
    {
      "name": "studio",
      "countries": [
        "Portugal",
        "Spain"
      ]
    }
  ]
}
```

### 401 Unauthorized

Type: `object`.

- `detail` (string, optional): Description of the error encountered.

### 403 Forbidden

Type: `object`.

- `detail` (string, optional): Description of the error encountered.

## Questions about this

- [What are the References operations for?](/docs/faq/what-is-references)
- [Does Casafari cover rentals and commercial property?](/docs/faq/rentals-and-commercial)