This page hasn't been translated for your language. Showing the English (United Kingdom) version.

Viewings and open houses

List and read the viewings of your own listings and the open houses on the Fondaro network through the Fondaro API.

The viewing and open house routes are reads and need properties:read; recording how a viewing went needs crm:write and an active plan. They are open to members and admins alike. A viewing or open house you cannot reach answers 404 with NOT_FOUND, the same as one that does not exist.

List viewings

GET /v1/viewings

Registered viewings of your agency's own listings, latest viewing time first. Filters combine. A viewing can have several clients (a couple or a family viewing together): leadId is the viewing's lead and otherLeadIds lists the others, empty when there are none. Notes are previews of up to 500 characters (notesTruncated says when one was cut); read one viewing for the full text.

ParameterInTypeRequiredDescription
limitQueryintegerNo1 to 100. Default 20
offsetQueryintegerNoRows to skip. Continue with nextOffset
fromQuerystringNoISO 8601 date-time. Viewings at or after it (inclusive)
toQuerystringNoISO 8601 date-time. Viewings before it (exclusive)
statusQuerystringNoscheduled, completed, cancelled or no_show
kindQuerystringNoin_person or virtual
propertyListingIdQueryUUIDNoOnly viewings of this own listing
leadIdQueryintegerNoOnly viewings for this lead, as the viewing's lead or one of its other clients
collaboratorLeadIdQueryintegerNoOnly viewings for this collaborating agency's lead
dealIdQueryUUIDNoOnly viewings of this deal
agentUserIdQuerystringNoOnly viewings held by this agent
bash
curl "https://api.fondaro.com/v1/viewings?limit=2" \  -H "Authorization: Bearer $FONDARO_API_KEY"
json
{  "data": [    {      "id": "3f6c2a10-0000-4000-8000-000000000013",      "propertyListingId": "3f6c2a10-0000-4000-8000-000000000012",      "leadId": null,      "otherLeadIds": [],      "collaboratorLeadId": null,      "agentUserId": "user_2abcDEF1234567890ghiJKL",      "dealId": null,      "viewingAt": "2026-09-29T09:30:00.000Z",      "kind": "in_person",      "status": "cancelled",      "feedback": null,      "feedbackAt": null,      "source": "user",      "createdBy": "user_2abcDEF1234567890ghiJKL",      "createdAt": "2026-09-29T09:20:06.646Z",      "updatedAt": "2026-09-29T09:20:36.632Z",      "notes": null,      "notesTruncated": false    }  ]}

The response also carries hasMore, nextOffset while there is more, and an exact total. Paging is by offset. Errors: 400 for a bad filter value.

Get a viewing

GET /v1/viewings/{viewingId}

One viewing of your agency by id, with its full notes. A lead id on it does not give you access to that lead.

ParameterInTypeRequiredDescription
viewingIdPathUUIDYesThe id of the viewing
bash
curl https://api.fondaro.com/v1/viewings/3f6c2a10-0000-4000-8000-000000000013 \  -H "Authorization: Bearer $FONDARO_API_KEY"

The response is the viewing, in the shape shown above. Errors: 404 NOT_FOUND.

feedback is how the viewing went, as its hosting agent answered: loved, maybe or no (not for them). It is null until answered, and feedbackAt says when it was given or last changed.

Record how a viewing went

POST /v1/viewings/{viewingId}/feedback

Records the answer on a viewing and replaces an earlier one. A scheduled viewing becomes completed, since an answer means it happened, and a note is added to the viewing's lead ("Viewing feedback, Calle Mayor 12: Loved it.") in your agency's language, written by the key's person. Only the member who registered the viewing, the agent hosting it or an admin can answer.

ParameterInTypeRequiredDescription
viewingIdPathUUIDYesThe id of the viewing
feedbackBodystringYesloved, maybe or no
noteBodystringNoUp to 2,000 characters. What else was said, added to the lead note
bash
curl -X POST https://api.fondaro.com/v1/viewings/3f6c2a10-0000-4000-8000-000000000013/feedback \  -H "Authorization: Bearer $FONDARO_API_KEY" \  -H "Content-Type: application/json" \  -d '{ "feedback": "loved", "note": "Wants a second viewing with her husband." }'

The response has id, status, feedback, feedbackAt and noteWritten, which is false when the viewing has no lead or you cannot open it (the answer is saved all the same). Errors: 403 FORBIDDEN when you may not change the viewing, 404 NOT_FOUND.

List open houses

GET /v1/open-houses

Open houses in one of two scopes: network (the default), the upcoming events other agencies opened to the Fondaro network, nearest first; or mine, your own agency's events in any status. Each row has the time window, the host agency, the commission offered to collaborating agents, how many agents are attending (goingCount), your own RSVP and a summary of the listing.

There is no paging. Narrow with from, to, area or one exact listing, up to 25 rows; hasMore says when more matched.

ParameterInTypeRequiredDescription
scopeQuerystringNonetwork (default) or mine
fromQuerystringNoISO 8601 date-time. Events ending after it. Default now
toQuerystringNoISO 8601 date-time. Events starting before it
areaQuerystringNoCity, area or community of the listing
sourceQuerystringNoOnly events whose listing comes from this source
listingSource, listingIdQuerystringNoBoth together: ask about one listing exactly
listingCountryQuerystringNoThe listing reference's country, when it has one
limitQueryintegerNo1 to 25. Default 10
bash
curl "https://api.fondaro.com/v1/open-houses?limit=2" \  -H "Authorization: Bearer $FONDARO_API_KEY"
json
{ "data": [], "hasMore": false }

A row carries id, status, visibility, startsAt, endsAt, timezone, host, isHost, commissionOffer, commissionNotes, goingCount, myRsvp, listingRef and a listing summary (title, reference number, type, city, area, price, currency, bedrooms, bathrooms and main image).

Get an open house

GET /v1/open-houses/{openHouseId}

One open house by id: the window, the host agency, the disclosed address, the commission offered, the invitation, the event contact and the listing. The listing owner's private commission is never included.

ParameterInTypeRequiredDescription
openHouseIdPathUUIDYesThe id of the open house
bash
curl https://api.fondaro.com/v1/open-houses/9d1f3a52-6b7e-4c0a-8f21-3e5b7a9c1d04 \  -H "Authorization: Bearer $FONDARO_API_KEY"

The response has the fields of a list row plus slug, disclosedAddress, mapUrl, contactName, contactPhone, hostUserId and invitation. Errors: 404 NOT_FOUND.