# List this account's alerts

> **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://platform.casafari.com/v1/claro/alerts/feed`

[Claro AI](/docs/claro) · [REST API](/docs/claro#rest-api). Send `Authorization: Bearer $CASAFARI_API_KEY`: a platform API key or OAuth access token, metered in platform tokens; see [platform sign-in](/docs/rest#platform-api-keys) and [Claro AI](/docs/claro#keys). On the platform this is `GET https://platform.casafari.com/v1/claro/alerts/feed`; `GET /v1/alerts/feed` is Claro's own path, which the platform adds `/claro` to. The platform forwards the call to Claro unchanged: Claro's `Claro-Version` header and its error bodies (`{"error":{"code","message"}}`, with `rate_limited` and `quota_reached` on a 429) pass through.

Over MCP: [`alerts`](/docs/claro/alerts) (equivalent). See [MCP and REST compared](/docs/parity#claro-ai).

## Description

The account's alert feed, oldest first: what Claro's email alerts told its people since `since`. Kinds: new_match (a unit new to the market that matches a saved search), price_cut_match and price_cut_saved (an asking rent or price cut by 3% or more, on a match or on a premises someone saved; `cut` has the old and new price, the percentage and the area's median asking price per m² when it rests on 10 or more units), saved_premises (a saved premises left the market, after `days_on_market` days, or came back; no reason is given) and area_pulse (new and withdrawn units, stock and median asking price per m² against the last pulse; rivals' places found in or no longer in an Overture Maps release; a footfall change only when a new Location Intelligence year landed). Units carry the pm_ id, price with price per m², days on the market, the agency and its `listing_url`; location figures only for accounts with location access. No descriptions or photos. Pass `next_since` from the answer as `since` to read on.

## Query parameters

- `since` (string, optional): Only items after this date or timestamp (2026-11-01 or 2026-11-01T06:30:00Z). Leave out for the last 30 days.
- `limit` (integer, optional): At most this many items; a page never ends inside one digest. Pass `next_since` as `since` to read on. 1–200; default 100.

## Example request

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

```bash
curl "https://platform.casafari.com/v1/claro/alerts/feed" \
  -H "Authorization: Bearer $CASAFARI_API_KEY"
```

## Responses

### 200 List this account's alerts

No body.

Example from the API description (long arrays shortened):

```json
{
  "items": [
    {
      "id": "price_cut_match:3f9a1c2e:pm_3kX9vQ2LmT8a:4140",
      "created_at": "2026-11-02T06:30:00.000Z",
      "kind": "price_cut_match",
      "token": "pm_3kX9vQ2LmT8a",
      "scope": "premises",
      "alert_id": "Zk3m9XpQ1aVb7LwE",
      "title": "Local comercial en esquina",
      "place": "Centro, madrid",
      "area_m2": 150,
      "price": {
        "op": "rent",
        "eur": 4140,
        "eur_per_m2": 27.6
      },
      "days_on_market": 63,
      "why": [
        "price",
        "street_level"
      ],
      "location": {
        "kind": "passers_by",
        "per_day": 4200
      },
      "agency": "Agencia Sol",
      "listing_url": "https://agenciasol.es/1",
      "cut": {
        "from_eur": 4500,
        "to_eur": 4140,
        "pct": 8,
        "area_median": {
          "eur_per_m2": 31.2,
          "n": 84
        }
      }
    },
    {
      "id": "saved_premises:3f9a1c2e:pm_7Rt2xLmN8bV4:withdrawn:2026-11-02",
      "created_at": "2026-11-02T06:30:00.000Z",
      "kind": "saved_premises",
      "token": "pm_7Rt2xLmN8bV4",
      "alert_id": "Qw7rT2xLmN8bV4cZ",
      "change": "withdrawn",
      "title": "Nave industrial",
      "place": "Getafe",
      "days_on_market": 112
    }
  ],
  "next_since": "2026-11-02T06:30:00.000Z"
}
```

### 400 Invalid request

Type: `object`.

- `error` (object, optional)
  - `code` (string, required)
  - `message` (string, required)

### 401 Missing or invalid key

Type: `object`.

- `error` (object, optional)
  - `code` (string, required)
  - `message` (string, required)

### 403 No access

Type: `object`.

- `error` (object, optional)
  - `code` (string, required)
  - `message` (string, required)

### 429 Rate limited

Type: `object`.

- `error` (object, optional)
  - `code` (string, required)
  - `message` (string, required)

## Related pages

- [Search commercial premises (POST /v1/search)](/docs/rest/claro/search-premises)
- [Refine a search (POST /v1/search/refine)](/docs/rest/claro/refine-search)
- [Get one premises (GET /v1/premises/{id})](/docs/rest/claro/get-premises)
- [Compare premises (POST /v1/compare)](/docs/rest/claro/compare-premises)
- [Claro AI: all its MCP tools and REST operations](/docs/claro)
- [Connect Claro to an MCP client](/docs/claro/connect)
- [MCP vs REST API compared](/docs/parity)
