{
  "opencollection": "1.0.0",
  "info": {
    "name": "Hospitable Public API v2",
    "version": "2.0"
  },
  "request": {
    "auth": {
      "type": "bearer",
      "token": "{{bearerToken}}"
    }
  },
  "items": [
    {
      "info": { "name": "Properties", "type": "folder" },
      "items": [
        {
          "info": { "name": "List properties", "type": "http" },
          "http": {
            "method": "GET",
            "url": "https://public.api.hospitable.com/v2/properties?include=listings",
            "params": [
              { "name": "include", "value": "listings", "type": "query", "description": "Related resources to include." }
            ]
          },
          "docs": "Lists the properties connected to the authenticated account, with pagination."
        },
        {
          "info": { "name": "Get a property", "type": "http" },
          "http": {
            "method": "GET",
            "url": "https://public.api.hospitable.com/v2/properties/:uuid",
            "params": [
              { "name": "uuid", "value": "", "type": "path", "description": "The property UUID." }
            ]
          },
          "docs": "Retrieves a single property by its UUID."
        },
        {
          "info": { "name": "Search available properties (modeled)", "type": "http" },
          "http": {
            "method": "POST",
            "url": "https://public.api.hospitable.com/v2/properties/search",
            "body": { "type": "json", "data": "{\n  \"start_date\": \"2026-08-01\",\n  \"end_date\": \"2026-08-05\",\n  \"guests\": 2\n}" }
          },
          "docs": "Searches connected properties for availability over a date range. Modeled endpoint - verify against the docs."
        }
      ]
    },
    {
      "info": { "name": "Listings", "type": "folder" },
      "items": [
        {
          "info": { "name": "List channel listings", "type": "http" },
          "http": {
            "method": "GET",
            "url": "https://public.api.hospitable.com/v2/listings"
          },
          "docs": "Lists the channel listings (Airbnb, Vrbo, Booking.com, direct) mapped to properties."
        }
      ]
    },
    {
      "info": { "name": "Reservations", "type": "folder" },
      "items": [
        {
          "info": { "name": "List reservations", "type": "http" },
          "http": {
            "method": "GET",
            "url": "https://public.api.hospitable.com/v2/reservations?start_date=2026-08-01&end_date=2026-08-31&include=guest,financials",
            "params": [
              { "name": "start_date", "value": "2026-08-01", "type": "query", "description": "Range start date." },
              { "name": "end_date", "value": "2026-08-31", "type": "query", "description": "Range end date." },
              { "name": "include", "value": "guest,financials", "type": "query", "description": "Related resources to include." }
            ]
          },
          "docs": "Lists reservations across connected channels, filterable by property and date range."
        },
        {
          "info": { "name": "Get a reservation", "type": "http" },
          "http": {
            "method": "GET",
            "url": "https://public.api.hospitable.com/v2/reservations/:uuid",
            "params": [
              { "name": "uuid", "value": "", "type": "path", "description": "The reservation UUID." }
            ]
          },
          "docs": "Retrieves a single reservation by its UUID."
        }
      ]
    },
    {
      "info": { "name": "Messages", "type": "folder" },
      "items": [
        {
          "info": { "name": "Get reservation messages", "type": "http" },
          "http": {
            "method": "GET",
            "url": "https://public.api.hospitable.com/v2/reservations/:uuid/messages",
            "params": [
              { "name": "uuid", "value": "", "type": "path", "description": "The reservation UUID." }
            ]
          },
          "docs": "Lists the guest-host message thread for a reservation."
        },
        {
          "info": { "name": "Send a message", "type": "http" },
          "http": {
            "method": "POST",
            "url": "https://public.api.hospitable.com/v2/reservations/:uuid/messages",
            "params": [
              { "name": "uuid", "value": "", "type": "path", "description": "The reservation UUID." }
            ],
            "body": { "type": "json", "data": "{\n  \"body\": \"Hi! Your check-in details are ready.\"\n}" }
          },
          "docs": "Sends a message to the guest on a reservation; Hospitable relays it to the underlying channel."
        }
      ]
    },
    {
      "info": { "name": "Calendar", "type": "folder" },
      "items": [
        {
          "info": { "name": "Get a property calendar", "type": "http" },
          "http": {
            "method": "GET",
            "url": "https://public.api.hospitable.com/v2/properties/:uuid/calendar?start_date=2026-08-01&end_date=2026-08-31",
            "params": [
              { "name": "uuid", "value": "", "type": "path", "description": "The property UUID." },
              { "name": "start_date", "value": "2026-08-01", "type": "query", "description": "Range start date." },
              { "name": "end_date", "value": "2026-08-31", "type": "query", "description": "Range end date." }
            ]
          },
          "docs": "Retrieves nightly availability, price, and restrictions for a property over a date range."
        },
        {
          "info": { "name": "Update a property calendar (modeled)", "type": "http" },
          "http": {
            "method": "PUT",
            "url": "https://public.api.hospitable.com/v2/properties/:uuid/calendar",
            "params": [
              { "name": "uuid", "value": "", "type": "path", "description": "The property UUID." }
            ],
            "body": { "type": "json", "data": "{\n  \"dates\": [\n    {\n      \"date\": \"2026-08-10\",\n      \"available\": true,\n      \"price\": { \"amount\": 25000, \"currency\": \"USD\" },\n      \"min_nights\": 2\n    }\n  ]\n}" }
          },
          "docs": "Updates availability and/or pricing for dates on a property calendar. Requires write access. Modeled endpoint - verify method and body against the docs."
        }
      ]
    },
    {
      "info": { "name": "Reviews", "type": "folder" },
      "items": [
        {
          "info": { "name": "List property reviews (modeled)", "type": "http" },
          "http": {
            "method": "GET",
            "url": "https://public.api.hospitable.com/v2/properties/:uuid/reviews",
            "params": [
              { "name": "uuid", "value": "", "type": "path", "description": "The property UUID." }
            ]
          },
          "docs": "Lists guest reviews for a property. Modeled endpoint - verify the exact path against the docs."
        },
        {
          "info": { "name": "Respond to a review (modeled)", "type": "http" },
          "http": {
            "method": "POST",
            "url": "https://public.api.hospitable.com/v2/reviews/:uuid/response",
            "params": [
              { "name": "uuid", "value": "", "type": "path", "description": "The review UUID." }
            ],
            "body": { "type": "json", "data": "{\n  \"body\": \"Thank you for staying with us!\"\n}" }
          },
          "docs": "Posts a public host response to a guest review. Modeled endpoint - verify against the docs."
        }
      ]
    },
    {
      "info": { "name": "User", "type": "folder" },
      "items": [
        {
          "info": { "name": "Get the authenticated user (modeled)", "type": "http" },
          "http": {
            "method": "GET",
            "url": "https://public.api.hospitable.com/v2/user"
          },
          "docs": "Returns the Hospitable user associated with the current token. Modeled endpoint - verify against the docs."
        }
      ]
    }
  ],
  "bundled": true
}