Get full details of a HomeExchange property (name, location, GPS, features, photos, owner info, descriptions, amenities). Descriptions include every language the owner wrote; pass locale to keep only one and save tokens.

Get a property's description texts by language, compact (title, good_feature, good_place, other per locale). Flags is_fallback when a requested language has no translation. Single API call — cheaper than he_get_home for comparing languages.

Get availability calendar for a single property. ⚠️ For multiple homes, use he_get_calendar_batch instead to avoid repeated calls.

Get availability calendars for multiple properties in one call. Prefer this over calling he_get_calendar repeatedly. Max 20 homes.

Get reviews and ratings for a HomeExchange property (cleanliness, expectations, communication scores, feedback text)

Get the list of property IDs saved as favorites by the authenticated user

Get the user's conversations list with pagination. Returns conversation metadata, last message preview, exchange details

Get messages from a specific conversation. Supports pagination via limit/offset.

Get a HomeExchange user's profile (name, verified status, number of exchanges, response rate, images)

Get a user's GuestPoints loyalty level and achievements

Get reviews/ratings about a user (as host and guest)

Get all properties owned by the authenticated user

Get the user's exchanges (upcoming, ongoing, or past) with pagination

Get detailed info about a single conversation (participants, exchanges, stay requests)

Get conversation statistics (unread count, total count)

Translate a message to a target language

Search through conversations by keyword

Search for homes/properties. Returns slimmed results (id, location, bedrooms, rating, owner, cover image).

⚠️ IMPORTANT: If you pass calendar.date_ranges in filters, results are ALREADY filtered by availability — do NOT call he_get_calendar on each result, it is redundant and wastes tokens. Only call he_get_calendar when you need the full availability breakdown of a specific home.

Full example with all filter categories: { "location": { "bounds": { "sw": { "lat": 36.0, "lon": -9.5 }, "ne": { "lat": 43.8, "lon": 4.3 } } }, "guests_nb": 4, "home": { "type": "home", "size": { "bedrooms": 2, "bathrooms": 1 }, "amenities": ["swimming-pool", "a-c", "wifi"], "surrounding": ["seaside"], "is_primary": true, "is_private_room": false, "exclude_animals": ["cat", "dog"] }, "calendar": { "date_ranges": [{ "from": "2026-08-05", "to": "2026-08-19" }] }, "exchange_type": "reciprocal", "filters": ["home-verified", "response-rate-above-threshold"] }

Filter reference

location: bounds {sw/ne with lat/lon} or location_id (Jawg polygon)

home.type: "home" (maison) | "flat" (appartement)

home.is_private_room: false (logement entier) | true (chambre privée)

home.is_primary: true (résidence principale) | false (résidence secondaire)

home.surrounding (array): "countryside" | "mountains" | "seaside" | "lakes" | "cities" | "villages" | "isolated" | "island"

home.amenities (array):

• Essentials: "heating-system" | "dishwasher" | "washing-machine" | "dryer" | "bathtub" | "tv" | "wifi" | "electric-car-plug"

• Comfort: "a-c" | "elevator" | "parking-space" | "jacuzzi" | "fireplace" | "gym" | "garden" | "balcony-terrace" | "swimming-pool" | "public-transit-access"

• Kids: "baby-bed" | "kids-toys" | "playground" | "baby-gear" | "secured-pool"

• Work: "dedicated-workspace" | "high-speed-connexion"

• Accessibility: "disabled-access" | "children-welcome" | "pets-welcome" | "smokers-welcome"

home.exclude_animals (array): "cat" | "dog" | "other"

home.eco_level: 4 (maisons durables uniquement)

exchange_type: "available" (all) | "reciprocal" | "guest-wanted" (GuestPoints only)

filters (array): "home-verified" | "response-rate-above-threshold" ← prefer this over min_response_rate param

calendar.date_ranges: [{ "from": "YYYY-MM-DD", "to": "YYYY-MM-DD" }] calendar.duration: { "kind": "week-end" | "week" | "month" }

guestpoint_range: { "min": 0, "max": 250 } (GP per night)

Get the user's subscription plan info (type, expiry, auto-renew status)

Get favorites with full property details (not just IDs). Paginated.

Get favorite folders (wishlists) with pagination

Add a property to favorites. Optionally specify a wishlist folder. IMPORTANT: ask user confirmation.

Remove a property from favorites. IMPORTANT: ask user confirmation.

Create a new favorites folder (wishlist). IMPORTANT: ask user confirmation.

Archive a conversation. IMPORTANT: ask user confirmation.

Unarchive a conversation. IMPORTANT: ask user confirmation.

Mark or unmark a conversation as favorite (star). IMPORTANT: ask user confirmation.

Pre-approve an exchange request. IMPORTANT: ask user confirmation.

Cancel an exchange with a reason. IMPORTANT: ask user confirmation.

Confirm/switch an exchange to reciprocal. Only needs the conversation ID: the correct home is auto-derived from the home already attached to your side of the conversation (passing a wrong home ID returns HTTP 500). senderHomeId is an optional hint, only used as a fallback when no home of yours is attached yet (pure GuestPoints conversation). IMPORTANT: ask user confirmation.

Change which home is proposed in an exchange. Use the exchange ID (not conversation ID) where you are the host. Get the exchange ID from conversation details (all_exchanges array, find the one where host=you). IMPORTANT: ask user confirmation.

Rate a home after an exchange (clean, expectation, communication: 1-5). IMPORTANT: ask user confirmation.

Send a message in an existing HomeExchange conversation. IMPORTANT: ask user confirmation before sending.

Send a first contact message to a property owner, creating a new conversation. exchange_type: 1=reciprocal, 2=guestpoints (omit to let API decide based on calendar). IMPORTANT: ask user confirmation before sending.

Update availability calendar periods for a property. Status: 1=available, 2=unavailable, 3=maybe. IMPORTANT: ask user confirmation.

Update property details (capacity, min_nights, features, etc.). IMPORTANT: ask user confirmation.

Update property description texts (title, good_feature, good_place, other). Omitted fields are preserved: current values of the target locale are merged in before the PUT. Use locale to create or update a specific language version. IMPORTANT: ask user confirmation.

Get users/homes that have favorited one of your properties (homecards). Useful to find potential exchange partners.

Get all saved searches

Get details of a specific saved search

Create a saved search from search filters. IMPORTANT: ask user confirmation.

Delete a saved search. IMPORTANT: ask user confirmation.

Get search history (last searches performed)

Get the list of valid exchange cancellation reasons

Get messages configuration (templates, auto-messages settings)

Archive multiple conversations at once. IMPORTANT: ask user confirmation.

Translate multiple messages at once

Update exchange dates for a conversation. IMPORTANT: ask user confirmation.

Check the current authentication status (logged in, token expiry, token source)

Inject access_token (and optionally refresh_token) for authentication. Get these from browser DevTools → Application → Cookies → homeexchange.fr

Manually trigger a token refresh using the stored PHPSESSID session cookie. Useful to test auto-renewal or force a new token before expiry. Only works if HE_COOKIES was used with a PHPSESSID value.

Inject a raw cookie string from the browser. Must contain oidc_access_token (or access_token). Include PHPSESSID to enable automatic token renewal. Get all cookies from DevTools → Application → Cookies → homeexchange.fr