# References REST API

> **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 operations, from the public OpenAPI description. Base URL `https://api.casafari.com`; every operation but sign-in needs a bearer token (see [the REST API overview](/docs/rest#get-a-token)).

Over MCP, References has no tools: see [MCP and REST compared](/docs/parity#references).

## Operations

- [`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.

## Questions about this

- [What are the References operations for?](/docs/faq/what-is-references)