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.
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 |
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 |
Errors: 400 for a listingId that is not a UUID.