# References

> **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).

The reference data requests are built from: property types, features and conditions, agencies, agents and the sources the graph is built from, locations with typeahead, and zip-code boundaries.

10 REST operations.

## REST API

10 operations in the public OpenAPI description, all under `https://api.casafari.com` with a bearer token ([how to get one](/docs/rest#get-a-token)). The same list with more detail: [References REST API](/docs/rest/references).

- [`GET /api/v1/references/agencies`](/docs/rest/references/get-agencies-v1): Get agencies (v1). Returns a list of all possible agencies with user restrictions.
- [`GET /api/v1/references/agents`](/docs/rest/references/get-agents-v1): Get agents (v1). Returns a list of all possible agents with user restrictions.
- [`GET /api/v1/references/conditions`](/docs/rest/references/get-conditions-v1): Get conditions (v1). Returns a list of all possible estate conditions.
- [`GET /api/v1/references/features`](/docs/rest/references/get-features-v1): Get features (v1). Returns a list of all possible property features.
- [`POST /api/v1/references/locations`](/docs/rest/references/get-locations-v1): Get locations (v1). Returns a list of all possible locations with user restrictions.
- [`GET /api/v1/references/locations/by-coordinates`](/docs/rest/references/get-location-by-passed-coordinates-v1): Get location by passed coordinates (v1). Returns a location for the given coordinates with user restrictions.
- [`POST /api/v1/references/locations/typeahead`](/docs/rest/references/get-locations-typeahead-suggestions-scoped-by-country-code-v1): Get locations typeahead suggestions scoped by country code (v1). Returns location typeahead suggestions within the given country (ES or PT).
- [`GET /api/v1/references/sources`](/docs/rest/references/get-sources-v1): Get sources (v1). Returns a list of all domains for the requested location.
- [`GET /api/v1/references/types`](/docs/rest/references/get-types-v1): Get types (v1). Returns a list of all possible estate types.
- [`POST /api/v1/references/zipcode-boundary`](/docs/rest/references/get-zipcode-boundary-by-zipcode-and-country-code-v1): Get zipcode boundary by zipcode and country code (v1). Get zipcode boundary by zipcode and country code.

## MCP and REST compared

Over MCP: 0 tools. Over REST: 10 operations. Available over REST only: MCP has no tool for it.

- Related: [`ma_get_location_typeahead`](/docs/area-insights/get_location_typeahead) and [`POST /api/v1/references/locations/typeahead`](/docs/rest/references/get-locations-typeahead-suggestions-scoped-by-country-code-v1).

Details: [MCP and REST compared](/docs/parity#references).

## Questions about this

- [Which products does Casafari MCP offer, and how many tools are there?](/docs/faq/which-products)
- [What are the References operations for?](/docs/faq/what-is-references)
- [How do I turn a place name into a location id?](/docs/faq/location-ids)
- [How do I build on the Casafari REST API?](/docs/faq/build-on-rest)