{
    "meta": {
        "api": "micasa-rentals",
        "apiVersion": "1",
        "schemaVersion": "2.0.0",
        "endpoint": "index",
        "generatedAt": "2026-08-27T20:02:28+00:00",
        "site": "https://www.micasa.rentals",
        "documentation": "https://www.micasa.rentals/api.php",
        "license": "Public listing data, free to use, cache and republish with attribution to Mi Casa Rentals.",
        "availability": {
            "source": "hospitable",
            "refreshedAt": "2026-08-27T14:04:09-05:00",
            "ageSeconds": 3499,
            "ttlSeconds": 3600,
            "stale": false
        }
    },
    "data": {
        "name": "Mi Casa Rentals public API",
        "description": "Live prices, fees, move-in costs, availability and full property detail for furnished, move-in-ready corporate and long-stay rentals in Pensacola, Florida. Read-only, unauthenticated, CORS-enabled, and free to use.",
        "authentication": "None. No key, no signup, no rate limit — please cache responses for a few minutes rather than polling in a loop.",
        "conventions": {
            "envelope": "Every response is { \"meta\": {...}, \"data\": {...} }. Errors replace \"data\" with \"error\".",
            "money": "All amounts are whole US dollars. Rent is monthly. The 6-month term is what the published rates are priced for, NOT a minimum stay — shorter stays are available and quoted separately.",
            "nulls": "null means \"not applicable or unknown\" and is never a missing key. A fee with disclosed=false has no published amount — report it as \"contact us\", never as $0.",
            "caching": "Responses carry an ETag and Cache-Control: max-age=300. Send If-None-Match to get a 304.",
            "freshness": "meta.availability reports when the booking calendar behind the response was last refreshed, and whether it is stale.",
            "pretty": "Output is pretty-printed by default; append ?pretty=0 for the compact form."
        },
        "endpoints": {
            "index": {
                "title": "Discovery",
                "url": "https://www.micasa.rentals/api/v1",
                "method": "GET",
                "summary": "Index of every endpoint, with the current schema version and links to the OpenAPI spec, JSON Schema, and MCP server.",
                "parameters": {}
            },
            "properties": {
                "title": "Properties",
                "url": "https://www.micasa.rentals/api/v1/properties",
                "method": "GET",
                "summary": "Every building: address, geo coordinates, amenities, utility billing, pet and parking policy, guest reviews, and what each one contains. Pass `property` for a single one, including all of its units.",
                "parameters": {
                    "property": {
                        "type": "string",
                        "required": false,
                        "description": "Property id or slug. Omit to list them all.",
                        "example": "gadsden-community"
                    },
                    "includeUnits": {
                        "type": "boolean",
                        "required": false,
                        "description": "Include full unit records in the list response. Default false (summaries only).",
                        "example": "true"
                    }
                }
            },
            "units": {
                "title": "Units & search",
                "url": "https://www.micasa.rentals/api/v1/units",
                "method": "GET",
                "summary": "The rentable units themselves, filterable by bedrooms, budget, occupancy and move-in date. Each carries live availability, resolved fees, a move-in cost breakdown, photos with alt text, and its canonical page URL. Pass `unit` for one unit with its full property context.",
                "parameters": {
                    "unit": {
                        "type": "string",
                        "required": false,
                        "description": "Unit id or slug. Returns one unit with its property context; ignores every filter below.",
                        "example": "rebecca-unit-a"
                    },
                    "propertyId": {
                        "type": "string",
                        "required": false,
                        "description": "Restrict to one property, by id or slug.",
                        "example": "gadsden-community"
                    },
                    "bedrooms": {
                        "type": "integer",
                        "required": false,
                        "description": "Exact bedroom count.",
                        "example": "3"
                    },
                    "minBedrooms": {
                        "type": "integer",
                        "required": false,
                        "description": "At least this many bedrooms.",
                        "example": "2"
                    },
                    "bathrooms": {
                        "type": "number",
                        "required": false,
                        "description": "At least this many bathrooms.",
                        "example": "2"
                    },
                    "minRent": {
                        "type": "integer",
                        "required": false,
                        "description": "Lowest monthly rent in USD.",
                        "example": "1500"
                    },
                    "maxRent": {
                        "type": "integer",
                        "required": false,
                        "description": "Highest monthly rent in USD. Rent excludes fees; whether it excludes utilities varies by property.",
                        "example": "2200"
                    },
                    "sleeps": {
                        "type": "integer",
                        "required": false,
                        "description": "Must sleep at least this many people.",
                        "example": "4"
                    },
                    "availableNow": {
                        "type": "boolean",
                        "required": false,
                        "description": "Only units open today.",
                        "example": "true"
                    },
                    "availableBy": {
                        "type": "string",
                        "required": false,
                        "description": "Only units open on or before this date (YYYY-MM-DD). Units with unknown availability are excluded rather than assumed open.",
                        "example": "2026-09-01"
                    },
                    "petsConsidered": {
                        "type": "boolean",
                        "required": false,
                        "description": "Only properties that do not rule pets out. Derived from free-text policy, so it is coarse — always read policies.pets for the real terms.",
                        "example": "true"
                    },
                    "utilitiesIncluded": {
                        "type": "boolean",
                        "required": false,
                        "description": "true = utilities already inside the advertised rent.",
                        "example": "true"
                    },
                    "featured": {
                        "type": "boolean",
                        "required": false,
                        "description": "Only units flagged as featured.",
                        "example": "true"
                    },
                    "limit": {
                        "type": "integer",
                        "required": false,
                        "description": "Maximum units to return, 1–100. Default 25.",
                        "example": "50"
                    }
                }
            },
            "pricing": {
                "title": "Pricing",
                "url": "https://www.micasa.rentals/api/v1/pricing",
                "method": "GET",
                "summary": "Every price in one call: monthly rent per unit, what utilities cost on top, the resolved fee set, and the total due at move-in. Includes a portfolio-wide price range. This is the endpoint to poll if all you track is what things cost.",
                "parameters": {
                    "unit": {
                        "type": "string",
                        "required": false,
                        "description": "Restrict to one unit, by id or slug.",
                        "example": "rebecca-unit-a"
                    },
                    "adults": {
                        "type": "integer",
                        "required": false,
                        "description": "Number of adult applicants, for per-applicant fees. Default 1.",
                        "example": "2"
                    }
                }
            },
            "move-in-costs": {
                "title": "Move-in costs",
                "url": "https://www.micasa.rentals/api/v1/move-in-costs",
                "method": "GET",
                "summary": "Itemized cost to move into one unit, split by when each line is actually due: at move-in, later under the lease, or only if a pet is approved. Undisclosed fees come back with amount null and disclosed false — never as $0.",
                "parameters": {
                    "unit": {
                        "type": "string",
                        "required": true,
                        "description": "Unit id or slug. Required.",
                        "example": "rebecca-unit-a"
                    },
                    "adults": {
                        "type": "integer",
                        "required": false,
                        "description": "Number of adult applicants, for per-applicant fees. Default 1.",
                        "example": "2"
                    }
                }
            },
            "availability": {
                "title": "Availability",
                "url": "https://www.micasa.rentals/api/v1/availability",
                "method": "GET",
                "summary": "Day-by-day calendar for one unit from the live booking system, or a portfolio-wide summary of what is open when no unit is named.",
                "parameters": {
                    "unit": {
                        "type": "string",
                        "required": false,
                        "description": "Unit id or slug. Omit for a summary across every unit.",
                        "example": "rebecca-unit-a"
                    },
                    "startDate": {
                        "type": "string",
                        "required": false,
                        "description": "Window start, YYYY-MM-DD. Defaults to today.",
                        "example": "2026-09-01"
                    },
                    "endDate": {
                        "type": "string",
                        "required": false,
                        "description": "Window end, YYYY-MM-DD. Defaults to one year out.",
                        "example": "2026-12-31"
                    }
                }
            },
            "ical": {
                "title": "iCalendar feed",
                "url": "https://www.micasa.rentals/api/v1/calendar.ics",
                "method": "GET",
                "summary": "Subscribable iCalendar (.ics) availability for one building. A VEVENT means the building is NOT available; a date with no event has at least one unit open. Buildings are pooled — a day is blocked only when every unit in it is booked — so the feed never discloses which unit. Omit `property` for the index of feed URLs.",
                "parameters": {
                    "property": {
                        "type": "string",
                        "required": false,
                        "description": "Property id or slug. Omit for a JSON index of every building feed.",
                        "example": "rebecca-street"
                    },
                    "startDate": {
                        "type": "string",
                        "required": false,
                        "description": "Window start, YYYY-MM-DD. Defaults to today.",
                        "example": "2026-09-01"
                    },
                    "endDate": {
                        "type": "string",
                        "required": false,
                        "description": "Window end, YYYY-MM-DD. Defaults to one year out.",
                        "example": "2026-12-31"
                    }
                }
            },
            "move-in-ready": {
                "title": "Move-in-ready inventory",
                "url": "https://www.micasa.rentals/api/v1/move-in-ready",
                "method": "GET",
                "summary": "What every unit comes stocked with beyond the furniture: an equipped kitchen with plates, glasses, cutlery and pans, beds made up with linens and towels, and a starter pack of toiletries and household supplies. Highlights rather than a full inventory — the response says so, and points at a contact for per-unit detail.",
                "parameters": {}
            },
            "catalog": {
                "title": "Full catalog",
                "url": "https://www.micasa.rentals/api/v1/catalog",
                "method": "GET",
                "summary": "The entire canonical catalog in one response — every property, every unit, every price, plus contact details. One request, complete state; use the narrower endpoints if you only need part of it.",
                "parameters": {}
            },
            "contact": {
                "title": "Contact",
                "url": "https://www.micasa.rentals/api/v1/contact",
                "method": "GET",
                "summary": "Phone, email, social profiles, and the booking and application links.",
                "parameters": {}
            },
            "openapi": {
                "title": "OpenAPI spec",
                "url": "https://www.micasa.rentals/api/v1/openapi.json",
                "method": "GET",
                "summary": "This API described as OpenAPI 3.1, for generating clients or handing to an agent framework.",
                "parameters": {}
            }
        },
        "contracts": {
            "openapi": "https://www.micasa.rentals/api/v1/openapi.json",
            "recordSchema": "https://www.micasa.rentals/schema/rental-catalog.schema.json",
            "documentation": "https://www.micasa.rentals/api.php",
            "mcpServer": "https://www.micasa.rentals/mcp.php",
            "llmsTxt": "https://www.micasa.rentals/llms.txt"
        },
        "catalogSummary": {
            "properties": 4,
            "units": 12,
            "priceRange": {
                "currency": "USD",
                "period": "month",
                "unitsPriced": 12,
                "rent": {
                    "min": 1550,
                    "max": 1975
                },
                "allIn": {
                    "min": 1550,
                    "max": 2375
                },
                "utilitiesExcludedFromSomeRents": true,
                "utilityBundleRange": {
                    "min": 300,
                    "max": 400
                },
                "statement": "Advertised rent runs $1,550–$1,975 per month. Utilities are inside the rent at some properties and cost $300–$400 per month at others, so the actual all-in monthly cost is $1,550–$2,375."
            },
            "moveInReady": {
                "summary": "Our rentals are not just furnished, they are equipped. The kitchen has the plates, glasses, cutlery, pots and pans; the beds are made up with linens and towels; and there is a starter pack of toiletries and household supplies waiting for you. Arrive with a suitcase, cook dinner the same evening, and sleep in a made bed that night.",
                "highlights": [
                    "A fully equipped kitchen — plates, glasses, cutlery, pots and pans",
                    "Beds made up on arrival, with linens and bath towels",
                    "A starter pack of toiletries and household supplies",
                    "Smart TV and high-speed Wi-Fi, already switched on",
                    "Furniture throughout, plus a desk or work surface"
                ],
                "detail": "https://www.micasa.rentals/api/v1/move-in-ready"
            }
        },
        "contact": {
            "phone": "(850) 912-9225",
            "email": "rentalspcola@gmail.com",
            "shortTermBookings": "https://micasa.directstays.com/",
            "longTermRentals": "https://www.avail.co/companies/micasa",
            "socialMedia": {
                "facebook": "https://www.facebook.com/micasa.pcola",
                "instagram": "https://www.instagram.com/micasa.rentals/"
            }
        }
    }
}