{
  "opencollection": "1.0.0",
  "info": {
    "name": "Landing API (HTTP GET) Public API",
    "version": "1.0.0"
  },
  "items": [
    {
      "info": {
        "name": "Public",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "List the Landing markets currently accepting bookings (one row per market).",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://www.hellolanding.com/api/public/markets",
            "params": [
              {
                "name": "state",
                "value": "AL",
                "type": "query",
                "description": "Optional 2-letter state abbreviation (e.g. \"AL\", \"TX\") to filter by."
              }
            ]
          },
          "docs": "List the Landing markets currently accepting bookings (one row per market)."
        },
        {
          "info": {
            "name": "Returns all available filter options for a given market — bedroom counts, amenities, price range, bathroom options, neighborhoods, and sort orders.",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://www.hellolanding.com/api/public/market-filters",
            "params": [
              {
                "name": "market",
                "value": "birmingham",
                "type": "query",
                "description": "Market slug (e.g. \"austin-tx\"). Use list_markets to discover slugs."
              }
            ]
          },
          "docs": "Returns all available filter options for a given market — bedroom counts, amenities, price range, bathroom options, neighborhoods, and sort orders."
        },
        {
          "info": {
            "name": "Search Landing's published furnished apartments in a given market.",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://www.hellolanding.com/api/public/search",
            "params": [
              {
                "name": "market",
                "value": "birmingham",
                "type": "query",
                "description": "Market slug (e.g. \"birmingham\", \"austin-tx\"). Use list_markets to discover slugs."
              },
              {
                "name": "check_in",
                "value": "2026-09-01",
                "type": "query",
                "description": "Move-in date (YYYY-MM-DD). Filters to homes available on or before this date."
              },
              {
                "name": "check_out",
                "value": "2026-12-01",
                "type": "query",
                "description": "Move-out date (YYYY-MM-DD) for a fixed stay, or \"indefinite\" for LandingFlex."
              },
              {
                "name": "bedrooms",
                "value": "1",
                "type": "query",
                "description": "Minimum bedroom count (0 = studio)."
              },
              {
                "name": "max_price",
                "value": "3500",
                "type": "query",
                "description": "Maximum monthly rent in USD."
              }
            ]
          },
          "docs": "Search Landing's published furnished apartments in a given market."
        },
        {
          "info": {
            "name": "Fetch a single Landing home by its slug — property details, amenities, photos, **flex pricing**, **the full availability calendar**, and a pre-filled `reservation_link` so the agent doesn't have to probe dates or assemble booking URLs by hand (get_apartment already returns the full calendar).",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://www.hellolanding.com/api/public/homes/:slug",
            "params": [
              {
                "name": "slug",
                "value": "apartment-in-birmingham-example",
                "type": "path",
                "description": "Home slug (e.g. \"apartment-in-birmingham-landing-midtown-200-5\")."
              }
            ]
          },
          "docs": "Fetch a single Landing home by its slug — property details, amenities, photos, **flex pricing**, **the full availability calendar**, and a pre-filled `reservation_link` so the agent doesn't have to probe dates or assemble booking URLs by hand (get_apartment already returns the full calendar)."
        },
        {
          "info": {
            "name": "Return the flex (open-ended) commitment tiers a given home accepts, so the agent doesn't suggest a `committed_nights` value the home will reject.",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://www.hellolanding.com/api/public/homes/:slug/flex-options",
            "params": [
              {
                "name": "slug",
                "value": "apartment-in-birmingham-example",
                "type": "path",
                "description": "Home slug to inspect."
              }
            ]
          },
          "docs": "Return the flex (open-ended) commitment tiers a given home accepts, so the agent doesn't suggest a `committed_nights` value the home will reject."
        },
        {
          "info": {
            "name": "Real, date-specific anonymous quote for a home. Mirrors what an unauthenticated visitor sees in checkout: monthly rent after seasonal adjustments and length-of-stay discounts, the first-month charge, ongoing monthly cost, and an estimated total.",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://www.hellolanding.com/api/public/homes/:slug/quote",
            "params": [
              {
                "name": "slug",
                "value": "apartment-in-birmingham-example",
                "type": "path",
                "description": "Home slug to quote."
              },
              {
                "name": "check_in",
                "value": "2026-09-01",
                "type": "query",
                "description": "Move-in date (YYYY-MM-DD)."
              },
              {
                "name": "check_out",
                "value": "2026-12-01",
                "type": "query",
                "description": "Move-out date (YYYY-MM-DD) for a fixed stay, or the literal string \"indefinite\" for flex."
              },
              {
                "name": "cats",
                "value": "",
                "type": "query",
                "description": "Number of cats, if any. Priced into charge_schedule; omit or pass 0 for no cats."
              },
              {
                "name": "dogs",
                "value": "",
                "type": "query",
                "description": "Number of dogs, if any. Priced into charge_schedule; omit or pass 0 for no dogs."
              }
            ]
          },
          "docs": "Real, date-specific anonymous quote for a home. Mirrors what an unauthenticated visitor sees in checkout: monthly rent after seasonal adjustments and length-of-stay discounts, the first-month charge, ongoing monthly cost, and an estimated total."
        },
        {
          "info": {
            "name": "Market context for a Landing market: average monthly rent by bedroom count, total published inventory, and the neighborhoods with the most availability — useful for cross-market comparisons (\"is Austin or Dallas cheaper for a 1BR?\") without paging through search_apartments.",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://www.hellolanding.com/api/public/market-info",
            "params": [
              {
                "name": "market",
                "value": "birmingham",
                "type": "query",
                "description": "Market slug. Use list_markets to discover slugs."
              },
              {
                "name": "home",
                "value": "apartment-in-birmingham-example",
                "type": "query",
                "description": "Optional. When given, the response also includes this home's neighborhood context (description, walk/transit/bike score)."
              }
            ]
          },
          "docs": "Market context for a Landing market: average monthly rent by bedroom count, total published inventory, and the neighborhoods with the most availability — useful for cross-market comparisons (\"is Austin or Dallas cheaper for a 1BR?\") without paging through search_apartments."
        },
        {
          "info": {
            "name": "Grounded, conservative answers to the most common Landing policy questions (deposits, pets, parking, cancellation, qualification, LandingFlex, utilities, move-in). Use this instead of guessing at policy specifics — where an exact number (deposit amount, cancellation window) depends on the home/market/reservation, the answer says so explicitly and points to get_quote, checkout, or Landing support rather than inventing a figure.",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://www.hellolanding.com/api/public/policies-faq",
            "params": [
              {
                "name": "q",
                "value": "pets",
                "type": "query",
                "description": "Optional — return only this topic's entry. Omit to get all entries."
              }
            ]
          },
          "docs": "Grounded, conservative answers to the most common Landing policy questions (deposits, pets, parking, cancellation, qualification, LandingFlex, utilities, move-in). Use this instead of guessing at policy specifics — where an exact number (deposit amount, cancellation window) depends on the home/market/reservation, the answer says so explicitly and points to get_quote, checkout, or Landing support rather than inventing a figure."
        },
        {
          "info": {
            "name": "Health check.",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://www.hellolanding.com/api/public/status"
          },
          "docs": "Health check."
        }
      ]
    }
  ],
  "bundled": true
}