Listing Collections

Overview

A collection is a named list of homes you keep together with other agents. It can hold homes from any connected source (the Fondaro network, Resales Online, the portals and the rest), and it replaces the dashboard Shortlist.

You create a collection in your active agency. You manage it: rename it, delete it, and add or remove people.
You can add a colleague (someone at one of your agencies) or someone you have an accepted conversation with on the network. People you have blocked, or who have blocked you, cannot be added.
Everyone in a collection can open it and add or remove homes. Anyone but the creator can leave.

Each person sees every home through their own agency. Another agency's home shows while it is on the market, with its street address and map position, and never with the owner's private commission. A home you can no longer open (sold, withdrawn, or from a source your agency has not connected) stays in the list with listing: null.

To share a collection, send its link in a conversation. Only people in the collection can open it.

Endpoints

Method & path	Who	Purpose
`GET /network/collections`	Any agent	The collections you are in
`POST /network/collections`	Any agent	Create one in your active agency
`GET /network/collections/:id`	Members	The collection, its people and its homes
`PATCH /network/collections/:id`	Creator	Rename
`DELETE /network/collections/:id`	Creator	Delete it and its homes
`POST /network/collections/:id/items`	Members	Add a home
`DELETE /network/collections/:id/items/:itemId`	Members	Remove a home
`POST /network/collections/:id/members`	Creator	Add a colleague or a connection
`DELETE /network/collections/:id/members/:userId`	Creator, or yourself to leave	Remove someone

The /network routes use the dashboard's Clerk bearer token and your active organization. They do not accept a property API key. A collection you are not in answers 404, whether or not it exists.

Limit	Value
Name	80 characters
Homes in one collection	200
People in one collection, you included	50
Collections you can create	100

List your collections

curl https://api.fondaro.com/network/collections \
  -H "Authorization: Bearer $TOKEN"

{
  "collections": [
    {
      "id": "5f0c2d8e-3b1a-4c7e-9a42-6d8e1f0b7c21",
      "name": "Golf frontline, three bedrooms",
      "itemCount": 6,
      "memberCount": 3,
      "isCreator": true,
      "createdAt": "2026-09-24T08:00:00.000Z",
      "updatedAt": "2026-09-24T09:12:00.000Z"
    }
  ]
}

Recently changed first.

Create a collection

curl -X POST https://api.fondaro.com/network/collections \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Golf frontline, three bedrooms" }'

Returns the new collection's summary. You are its first member.

Get one collection

curl https://api.fondaro.com/network/collections/5f0c2d8e-3b1a-4c7e-9a42-6d8e1f0b7c21 \
  -H "Authorization: Bearer $TOKEN"

{
  "id": "5f0c2d8e-3b1a-4c7e-9a42-6d8e1f0b7c21",
  "name": "Golf frontline, three bedrooms",
  "itemCount": 2,
  "memberCount": 2,
  "isCreator": true,
  "createdAt": "2026-09-24T08:00:00.000Z",
  "updatedAt": "2026-09-24T09:12:00.000Z",
  "members": [
    { "clerkUserId": "user_2abc…", "firstName": "Lucia", "lastName": "Moreno", "imageUrl": null, "isCreator": true },
    { "clerkUserId": "user_2def…", "firstName": "Tom", "lastName": "Berg", "imageUrl": "https://…", "isCreator": false }
  ],
  "items": [
    {
      "id": "b7e1a2c4-0f3d-4e59-8a61-2c9d7e0f1a33",
      "ref": { "source": "internal", "id": "a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d" },
      "addedByUserId": "user_2def…",
      "createdAt": "2026-09-24T09:12:00.000Z",
      "listing": {
        "ref": { "source": "internal", "id": "a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d" },
        "source": "internal",
        "title": "Garden apartment",
        "price": 650000,
        "currency": "EUR",
        "bedrooms": 3,
        "city": "Marbella",
        "address": { "line1": "Calle Ejemplo 7", "postalCode": "29660" },
        "latitude": 36.4912,
        "longitude": -4.9876,
        "sharedCommission": 3
      }
    },
    {
      "id": "0c4f9e2a-7d1b-4a38-b5e6-3f2a1c0d9e84",
      "ref": { "source": "resales_online", "id": "R4471123", "country": "ES" },
      "addedByUserId": "user_2abc…",
      "createdAt": "2026-09-24T08:05:00.000Z",
      "listing": null
    }
  ]
}

Homes are newest first. listing has the same fields as an open house's listing. addedByUserId is null when the person who added the home has deleted their account.

Add or remove a home

curl -X POST https://api.fondaro.com/network/collections/5f0c2d8e-3b1a-4c7e-9a42-6d8e1f0b7c21/items \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "ref": { "source": "resales_online", "id": "R4471123", "country": "ES" } }'

ref is the home's ListingRef, as the property sources return it. You can only add a home your agency can open now and that is on the market. Adding a home twice returns the same item.

curl -X DELETE https://api.fondaro.com/network/collections/5f0c2d8e-3b1a-4c7e-9a42-6d8e1f0b7c21/items/0c4f9e2a-7d1b-4a38-b5e6-3f2a1c0d9e84 \
  -H "Authorization: Bearer $TOKEN"

Answers 204, also when the home was already gone.

Add or remove a person

curl -X POST https://api.fondaro.com/network/collections/5f0c2d8e-3b1a-4c7e-9a42-6d8e1f0b7c21/members \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "clerkUserId": "user_2def…" }'

Take the id from GET /network/connections. Returns the person as the collection shows them. Adding someone twice changes nothing.

curl -X DELETE https://api.fondaro.com/network/collections/5f0c2d8e-3b1a-4c7e-9a42-6d8e1f0b7c21/members/user_2def… \
  -H "Authorization: Bearer $TOKEN"

Use your own id to leave. The creator cannot leave; delete the collection instead.

Errors

Status	`code`	When
404	`LISTING_COLLECTION_NOT_FOUND`	No such collection, or you are not in it
403	`LISTING_COLLECTION_CREATOR_ONLY`	Renaming, deleting or managing people when you did not create it
403	`LISTING_COLLECTION_ORGANIZATION_REQUIRED`	Your active organization is not an agency you are part of
422	`LISTING_COLLECTION_LISTING_UNREADABLE`	Your agency cannot open that home, or it is off the market
422	`LISTING_COLLECTION_MEMBER_NOT_CONNECTED`	The person is not a colleague or a connection, is blocked, or is not on the network
422	`LISTING_COLLECTION_LIMIT_REACHED`	You already created 100 collections
422	`LISTING_COLLECTION_ITEMS_FULL`	The collection holds 200 homes
422	`LISTING_COLLECTION_MEMBERS_FULL`	The collection has 50 people
400	`LISTING_COLLECTION_CREATOR_CANNOT_LEAVE`	The creator tried to leave