# Bungalow

> Bungalow is a US residential rental platform for single-family homes, operating a co-living product
> (individual rooms leased to separately screened housemates) and a whole-home product (a house leased
> to one group). It publishes a small, anonymous, read-mostly public REST API — the Bungalow API at
> fieldstone.bungalow.com — so third-party listing sites and rental portals can syndicate its markets
> and property listings, read showing availability, book a showing, and submit an application source.
> Founded 2017; headquartered in Miami, FL; roughly 23 active US markets.

Generated by the API Evangelist enrichment pipeline on 2026-08-01. Bungalow publishes no llms.txt of
its own — https://bungalow.com/llms.txt returns HTTP 200 but the body is the single-page-app HTML
shell, not a document.

Key facts an agent should know before calling this API:

- Authentication: **none**. The public JSON API is anonymous. Send no key.
- `GET /markets/` is the mandatory entry point — `GET /listings/properties/` requires `market__slug`
  and there is no global property enumeration.
- Branch on `property_marketing_type`: `group_living` prices from `full_property_price`; `co_living`
  prices from the `room_prices` array.
- Co-living street addresses and lat/long are deliberately obfuscated by the provider. Full addresses
  are provided only for whole-home rentals.
- Listing data refreshes about every 10 minutes; do not let a cache go older than 24 hours.
- Bungalow asks that third-party surfaces only post a listing when the earliest availability date is
  under 30 days out.
- There is **no idempotency key**. The two write operations (book a showing, submit an application)
  create real-world commitments and are not safely retryable.
- Errors are a proprietary `{"error": {code, type, message}}` envelope, not RFC 9457.
- Ids are declared `integer` in the spec but returned as decimal strings. Keep them as strings.

## APIs

- [Bungalow API](https://fieldstone.bungalow.com/api/v1/docs/): Anonymous public REST API for markets, property listings, showing availability, showing booking, and application sources. Base URL https://fieldstone.bungalow.com/api/v1/

## Specs

- [OpenAPI 3.0.2 (live)](https://fieldstone.bungalow.com/api/v1/open-api-schema/): The provider's own machine-readable contract, served as application/vnd.oai.openapi
- [OpenAPI 3.0.2 (harvested verbatim)](openapi/bungalow-openapi-original.yml): 7 operations across 4 tags — Markets, Listings, Showings, Applications

## Operations

- `GET /markets/` — list all active markets
- `GET /markets/{id}` — get one market with demand metrics
- `GET /listings/properties/` — list marketable properties (requires `market__slug`; 19 filters)
- `GET /listings/properties/{id_or_slug}` — get one property in full detail
- `GET /listings/showings/availability/{id}/` — showing timeslot grid for a property
- `POST /listings/showings/` — book a showing (in-person or virtual)
- `POST /applications/source/` — create an application source and get a public application URL

## Docs

- [API reference](https://fieldstone.bungalow.com/api/v1/docs/)
- [Getting started](https://fieldstone.bungalow.com/api/v1/docs/#section/Getting-Started)
- [Errors](https://fieldstone.bungalow.com/api/v1/docs/#section/Errors)
- [Pagination](https://fieldstone.bungalow.com/api/v1/docs/#section/Pagination)
- [Versioning](https://fieldstone.bungalow.com/api/v1/docs/#section/Versioning)

## Artifacts

- [Authentication](authentication/bungalow-authentication.yml): anonymous public API; partner-gated XML feeds
- [Conventions](conventions/bungalow-conventions.yml): pagination, versioning, error envelope, throttling, no idempotency
- [Error catalog](errors/bungalow-problem-types.yml): 14 documented error types, none of them in the spec
- [Data model](data-model/bungalow-data-model.yml): Market, MarketArea, Property, HouseProfile, ShowingAvailability, Showing, ApplicationSource
- [Webhooks](asyncapi/bungalow-webhooks.yml): inbound partner lead-capture webhook; no outbound events
- [Lifecycle](lifecycle/bungalow-lifecycle.yml): uri-path v1, semver, no deprecation policy, no status page
- [Conformance](conformance/bungalow-conformance.yml): OpenAPI 3.0, REST, semver, Hotpads + Facebook Catalog feeds; not RESO, not RFC 9457
- [MCP candidate](mcp/bungalow-mcp.yml): 7 candidate tools derived from the spec — Bungalow ships no MCP server
- [Tool crosswalk](mcp/bungalow-tool-crosswalk.yml): 1:1 tool-to-operation binding
- [Agent skills](skills/_index.yml): syndicate listings, book a showing, capture a lead
- [Well-known](well-known/bungalow-well-known.yml): no security.txt, no OIDC, no agent card
- [Domain security](security/bungalow-domain-security.yml): TLS 1.3 + HSTS on the website, SPF + DMARC p=reject, no DNSSEC, no CAA

## Other surfaces

- Partner XML feeds — Hotpads and Facebook Catalog formats, authenticated, richer field set than the
  public JSON API. Request via integrations@bungalow.com. MITS listed as possible future support.
- Lead-capture webhook — partner posts leads to Bungalow. Provisioned per partner via
  integrations@bungalow.com.

## Company

- [Website](https://bungalow.com/)
- [About](https://bungalow.com/about)
- [Blog](https://bungalow.com/articles)
- [FAQ](https://bungalow.com/faq)
- [Press](https://bungalow.com/press)
- [Careers](https://bungalow.com/careers)
- [Terms of Service](https://bungalow.com/terms-of-use)
- [Privacy Policy](https://bungalow.com/privacy-policy)