# Network

> List the listing collections you are in and the buyer requests on the Fondaro network through the Fondaro API.

The network is how agencies on Fondaro share homes and needs with each other. These routes are reads and need `properties:read`. They are open to members and admins alike, and none needs an active plan.

## List collections

`GET /v1/collections`

The listing collections you are in, recently changed first, up to 25. A collection is a named set of homes an agent shares with colleagues or connections. There is no paging; `hasMore` is `true` when more exist.

```bash
curl https://api.fondaro.com/v1/collections \
  -H "Authorization: Bearer $FONDARO_API_KEY"
```

```json
{ "data": [], "hasMore": false }
```

A row carries `id`, `name`, `homeCount` and `updatedAt`.

## Get a collection

`GET /v1/collections/{collectionId}`

One collection you are in: its name and its homes, newest first, up to 40 (`truncated` is `true` when there are more). Another agency's home shows only while it is active and never with its private commission. A home you can no longer open comes back with `unavailable: true` and only its reference.

| Parameter | In | Type | Required | Description |
|-----------|----|------|----------|-------------|
| `collectionId` | Path | UUID | Yes | The id of the collection |

```bash
curl https://api.fondaro.com/v1/collections/5b1e7c20-3a4d-4f68-9c12-7d8e0f1a2b34 \
  -H "Authorization: Bearer $FONDARO_API_KEY"
```

The response has `id`, `name`, `homeCount`, `truncated` and `items`. An item has `itemId`, `id` (the listing id), `source`, `ref` (`{ "source", "id" }`) and `unavailable`. Errors: `404` `NOT_FOUND` for a collection that does not exist or that you are not in.

## List buyer requests

`GET /v1/buyer-requests`

A request is what a buyer is looking for (place, type, bedrooms, price). It never contains a buyer's name or contact details. There are two modes:

- **Without `listingId`:** your own requests, in every status, across every agency you belong to.
- **With `listingId`:** the open requests from other agencies that fit that listing. The listing is any active Fondaro MLS listing you can read on the network.

Up to 25 rows; `hasMore` says when there are more.

| Parameter | In | Type | Required | Description |
|-----------|----|------|----------|-------------|
| `listingId` | Query | UUID | No | A Fondaro MLS listing id, to see the open requests that fit it |

```bash
curl https://api.fondaro.com/v1/buyer-requests \
  -H "Authorization: Bearer $FONDARO_API_KEY"
```

```json
{
  "data": [
    {
      "id": "3f6c2a10-0000-4000-8000-000000000017",
      "summary": "Sale in Estepona, 3+ bedrooms, up to EUR 900,000",
      "createdAt": "2026-09-25T15:00:11.805Z"
    },
    {
      "id": "3f6c2a10-0000-4000-8000-000000000016",
      "summary": "Sale in Marbella",
      "createdAt": "2026-09-24T20:04:55.865Z"
    }
  ],
  "hasMore": false
}
```

Errors: `400` for a `listingId` that is not a UUID.

Source: https://www.fondaro.com/docs/api/v1/network