For housing providers
If you manage homes rather than place families, this is your half of the API.
https://api.havnly.ai/functions/v1/propertiesA provider key is not a carrier key: it belongs to your account, and it reaches your portfolio rather than anyone’s housing requests.
What it covers
- Your portfolio — publish homes, keep them current, a hundred per call
- Availability — block dates you have taken back, see what Havnly is holding
- Bookings and payouts — what has been placed, what it earned, and whether we can pay you
How a home gets placed
- You publish it. Address, rate, bedrooms, photos, when it is free.
- It is verified. Only complete listings are shown to adjusters — the API tells you which of yours are not.
- An adjuster places a family in it. You are notified, and the calendar is held for those dates.
- You countersign the lease. The tenant or the placement team signs first.
- You are paid. Rent is charged on your own Stripe account; Havnly’s fee comes off the rent, never the deposit.
Steps 1, 2 and 3 you can drive or watch through the API. Step 4 is a signature in a browser. Step 5 lands in your bank account.
A word on idempotency
Send your own id for each home as external_id. Re-syncing your portfolio then
updates each home instead of creating a second copy of it — which is what
you want when the nightly export runs again.