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.

ParameterInTypeRequiredDescription
collectionIdPathUUIDYesThe 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.

ParameterInTypeRequiredDescription
listingIdQueryUUIDNoA 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.