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

Alert feeds that follow the property graph for a set of filters: new properties, price rises and cuts, reservations, delistings and sales. Create a feed, read its alerts, or have them delivered to your webhook.

12 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, Alerts has no tools: see [MCP and REST compared](/docs/parity#alerts).

## Alerts

Paths under `/api/v1/listing-alerts`.

- [`GET /api/v1/listing-alerts/feeds`](/docs/rest/alerts/get-feeds-list-v1): Get feeds list (v1). Returns all alerts feeds for currently authenticated user.
- [`POST /api/v1/listing-alerts/feeds`](/docs/rest/alerts/create-feed-v1): Create feed (v1). Create alerts feed for currently authenticated user.
- [`GET /api/v1/listing-alerts/feeds/{id}`](/docs/rest/alerts/get-alerts-by-feed-v1): Get alerts by feed (v1). Returns paginated list of alerts (by feed ID) for currently authenticated user.
- [`DELETE /api/v1/listing-alerts/feeds/{id}`](/docs/rest/alerts/delete-feed-v1): Delete feed (v1). Delete alerts feed (by feed ID) for currently authenticated user.
- [`PUT /api/v1/listing-alerts/feeds/{id}/update`](/docs/rest/alerts/update-feed-v1): Update feed (v1). Update alerts feed by id.
- [`POST /api/v1/listing-alerts/search`](/docs/rest/alerts/search-alerts-v1): Search alerts (v1). Returns paginated list of alerts (by requested parameters) for currently authenticated user.

## Feeds

Paths under `/alerts-api/feeds`.

- [`GET /alerts-api/feeds`](/docs/rest/alerts/list-feeds): List feeds. Returns a paginated list of feeds, sorted newest first.
- [`POST /alerts-api/feeds`](/docs/rest/alerts/create-feed): Create feed. Create a new alert feed that delivers matching real estate events to your webhook URL.
- [`GET /alerts-api/feeds/{feed_id}`](/docs/rest/alerts/get-feed): Get feed. Returns the feed configuration in the same format as it was originally created.
- [`DELETE /alerts-api/feeds/{feed_id}`](/docs/rest/alerts/delete-feed): Delete feed. Permanently removes the feed.

## Webhooks

Paths under `/alerts-api/webhooks`.

- [`PUT /alerts-api/webhooks`](/docs/rest/alerts/set-webhook-url): Set webhook URL. Sets (or replaces) the delivery URL for all your alert feeds.
- [`POST /alerts-api/webhooks/rotate-secret`](/docs/rest/alerts/rotate-signing-secret): Rotate signing secret. Issues a new current signing secret.

## Questions about this

- [Can I get alerts (new properties, price cuts, sales) over Casafari MCP?](/docs/faq/alerts-over-mcp)
- [How do I get alerts delivered to a webhook?](/docs/faq/alerts-webhook)