Homejourney Singapore property listings

Use this when a buyer asks whether they may buy a landed home in Singapore (terrace, semi-detached, detached or bungalow, cluster or townhouse, Good Class Bungalow), or before a PR or foreigner asks to view a landed listing. It applies the Residential Property Act as SLA states it: citizens may buy any landed home; PRs need SLA approval, which SLA gives case by case to PRs of at least 5 years, and the Ministry of Law has approved no foreign buyer for a Good Class Bungalow since 2021; a foreigner who is not a PR is not approved for landed homes; and anyone may buy a condominium unit or a strata landed house within an approved condominium. Pass the buyer's residency and a listing_id from search_listings, or property_kind. A landed listing does not always record its house type, and never whether it is strata within a condominium, so pass property_kind too when the user knows it; whether it is in a Good Class Bungalow area comes from its location. Returns allowed, needs_sla_approval or not_allowed, the reason, the next step and SLA links. Always give the user the disclaimer: it is general information, not legal advice. Needs no sign-in and stores nothing about the buyer.

Use this after search_listings or list_saved_properties when the user wants two to six Homejourney listings compared side by side. Pass their listing_ids (a saved home's property_id), and optionally the user criteria: budget, bedrooms, bathrooms, preferred districts or MRT stations, the longest acceptable walk to the MRT, the fewest years of lease that must remain, and must-have features. Returns the listings ranked against those criteria, each with its score out of 100 (null when no criterion given can be judged) and the points it earns on each criterion, the reasons it fits, its tradeoffs and any missing data, plus price, size, nearest MRT, nearby schools, the nearest childcare centres and preschools and, for an HDB flat, the lease left on its block. Never returns owner or agent contact details. To show the result as a card, pass it to render_shortlist.

Fetch one Homejourney listing or guide by the ID that search returned, for deep-research and citation hosts. Returns the listing text, without owner or agent contact details, or the whole text of the guide, with its Homejourney URL for citations. After search_listings, use get_listing_details instead.

Use the opaque status token returned by prepare_guest_service_checkout to check card approval, provider, completion, and payment state. Returns no contact or address details.

Use this after search_listings when the user wants the full details of one Homejourney listing, such as its description, size, tenure, furnishing, availability, nearest MRT, nearby schools, the MRT stations open or under construction, primary schools by 1 km and 2 km band, secondary schools, supermarkets, hawker centres, CHAS clinics, parks, malls, bus stops with their bus numbers, and childcare centres and preschools near it, and Homejourney link. For an owner listing, including a flat its owner lists on HDB Flat Portal, it adds reportUrl, where the user reports a wrong, misleading or scam listing to Homejourney. For an HDB rental, tenantEligibility says who may rent it: the 6-month minimum, the pass a non-citizen needs and, for a whole flat, the HDB non-citizen quota with a link to the HDB quota checker; use it when the user is a PR or a foreigner. Never returns owner or agent contact details.

Use this first when an owner wants to sell or rent out their own home on Homejourney, before asking them anything. Returns every field to collect (required or optional, allowed values, examples, which apply only to HDB, condo, landed or rentals), the photo rules, where to order a floor plan, the HDB and URA letting rules (rentalRules) to check with a landlord before collecting the rental details, with the HDB ones in ruleGroups by what is let (the whole flat, rooms, or every HDB rental), and the steps in order: the agent saves the details with create_listing_draft, then the owner adds photos or confirms the ones you add, verifies with Singpass, joins Homejourney Pro and publishes. Ask the owner for all required fields in one message. Needs no sign-in.

Use this to book for a customer who is not signed in to Homejourney here, such as on the public connector; it needs no Homejourney account. A user signed in on this connector books for themselves with create_service_booking instead. After the customer confirms the selected provider package, the exact price, schedule, address, customer-provided email and mobile number, and contact consent, it returns one branded Homejourney review-and-authorization link. No OTP is required. The customer saves a card there for the exact booking, or chooses PayNow. Tell the customer: "Nothing is charged or held now. We charge your card, or send a PayNow request, after the job is done." The booking appears in the Homejourney account of the customer once they sign in with the same verified email or WhatsApp number. When someone else lets the technician in, such as a tenant, add them as onsite_contact.

Use this after search_services with the selected provider and package identifiers. Returns the exact server-revalidated price before confirmation and does not create a booking row. A quote needs no name, email, or phone. A provider package also returns the assignment deadline, after which an unaccepted booking is cancelled at no charge; it needs an exact start at least 2 hours away. An operator price quoted with the service address also returns slots, the open arrival times there on scheduled_date with the total for each; book one of those times. Without the address no time is checked, and the quote leads with requested_time_open: unknown. When none is open, slotsUnavailableReason says whether the address has no postal code, the postal code matches no address, or the provider does not serve it; otherwise the date is full, and nextOpenDates names the next dates with open times in the 14 days after it (empty when none opens), so quote one of those dates. availableExtras lists the extras the provider sells with the job, such as sofa steaming; quote again with the ones the customer wants in extras to get the total with them, and book with the same extras. A package named for a unit count ("3 wall units") is refused for another number_of_units with reason package_unit_count; quote the package for the asked count instead. Other refusals say what to change: start_too_soon names the first open start after the window when the quote has the service address and asks for the address otherwise, price_changed the new price, invalid_catalog_version the current catalog_version_id, and quote_required means the package cannot be booked on Homejourney.

Show one Homejourney listing as a visual card with its photos, key details and a button to open it on Homejourney. Use this when the user wants to look at one listing. Never shows owner or agent contact details.

Show a comparison that compare_listings returned as a visual shortlist card. Use this after compare_listings when the host can display app cards; pass the comparison unchanged.

Search active Homejourney Singapore property listings for deep-research and citation hosts. Broad availability questions are supported; use location, project, or feature keywords only when the user supplied them. Returns canonical listing URLs for citations. When no listing matches, returns the Homejourney guides that answer the question (IDs starting guide:), or an empty list with a note naming the next tool. To filter by price, bedrooms, area or rent terms, use search_listings instead.

Use this when someone asks about a Singapore property agent (salesperson) by name or CEA registration number, such as R028241G, including an agent asking what Homejourney shows about them, or wants agents who work in an area or at an agency. The query searches names and CEA numbers only: for agents in an area, such as an HDB seller in Tampines, pass area, alone or with agency. Returns matching agents on CEA's register with their agency, CEA number, Homejourney listing count and public profile URL; with an area, agents with the most CEA-recorded deals there in the last three years come first, then those with the latest deal, each with their sales and rentals there and their latest deal month. Pass deal_type sale for a seller or buyer, so agents rank by their sales there, or rental for a landlord or tenant; without it every deal counts, and most HDB agent deals are rentals. Pass property_type to rank them by their deals in one kind of home there, such as landed for a landed home seller in D10. For a CEA number, or a name only one agent matches, it also returns the profile: transactions CEA records for them, their top areas and their public Homejourney listings, whose ids get_listing_details reads. Never returns contact details; send the user to the profile URL. Needs no sign-in.

Use this when someone asks how buying, selling, renting or letting a home in Singapore works: grants and eligibility, BTO and resale, stamp duty, loans and down payments, the MOP, tenancy agreements, or renting out a flat or room. Also use it when a property agent asks how Homejourney works for agents: co-broking and CEA rules, verifying with Singpass, listing for clients, and viewing requests. Also use it when someone asks how to manage their Homejourney account: changing the sign-in email, resetting the password, verifying the email, or editing the profile. Returns Homejourney's reviewed guides and help articles that match, each with its URL, a short answer, who it is for (no persona means everyone), whether it has a calculator, and the date it was last checked. Cite the URL and its date. Filter with persona (buyer, seller, renter, landlord, foreigner or agent); leave query empty to list every guide for that persona. Needs no sign-in.

Primary listing-discovery tool for homes in Singapore. Use this when the user asks what properties are available, or describes a home to buy or rent by area, MRT station, school, budget, bedrooms, flat type or other criteria. Omit query for a broad availability request; query is full-text search over project, title, address and description. pagination.total is the exact number of matching listings; the listings one agent has at one address or in one development on a page come back as one result whose listingCluster names the others. Returns summaries of active, published Homejourney listings that may be shown in AI assistants: price, size, address, nearest MRT, nearby schools, a Homejourney link and a link to book a viewing, but never the owner or agent contact details.

Use this to find active Homejourney services. Each result carries the provider, package, catalogue version, and price required for quoting and checkout. Every result sells under its provider's own name and logo (soldUnder "provider"): a large operator's at its own published price, a small shop's at Homejourney's standard price; priceSetBy says which. A service can list both. A home-size package's suitable_for names the HDB flat type its floor area fits, such as 4-room HDB, even when the brand's own name counts fewer bedrooms. Booking saves a card. Booked signed in with create_service_booking: "Nothing is charged now. We hold the amount once the provider accepts, and charge it after the job is done." Booked with prepare_guest_service_checkout: "Nothing is charged or held now. We charge your card, or send a PayNow request, after the job is done." For a service priced by home size, such as move-in cleaning, pass the home's floor_area_sqft, hdb_flat_type or bedrooms to get each provider's one package for that home; noPackageForHomeSize names providers with none. For aircon, pass unit_type and units (or say them in the query, as in "2 wall units") to get each provider's one package for those units; noPackageForUnits names providers with none. A search for an architect, engineer or builder, or about extending, adding a storey or attic, or rebuilding a landed house, also returns landedWorks: whether the plan is likely A&A or reconstruction, its approvals and how to record the owner's request.