HolidayFox

Search HolidayFox for UK holiday accommodation — farm stays, glamping, shepherd huts, caravan and camping pitches, and self-catering cottages. Filter by area and by amenity/audience tags. When checkinDate and checkoutDate are supplied, each result carries the live total price for that exact stay and only genuinely bookable options are counted. Returns destination ids used by the other tools.

{
  "type": "object",
  "properties": {
    "area": {
      "type": "string",
      "description": "Region key, lowercase and hyphenated, e.g. \"cornwall\", \"north-devon\", \"peak-district\"."
    },
    "tags": {
      "type": "array",
      "description": "Optional facet filters, e.g. [{\"key\":\"hot-tub\",\"category\":\"AMENITY\"}].",
      "items": {
        "type": "object",
        "properties": {
          "key": {
            "type": "string"
          },
          "category": {
            "type": "string",
            "enum": [
              "ACTIVITY",
              "AMENITY",
              "AUDIENCE",
              "DESCRIPTION",
              "LOCATION",
              "ACCOMMODATION",
              "RESTRICTION"
            ]
          }
        },
        "required": [
          "key",
          "category"
        ],
        "additionalProperties": false
      }
    },
    "checkinDate": {
      "type": "string",
      "description": "YYYY-MM-DD. Supply with checkoutDate for live stay pricing."
    },
    "checkoutDate": {
      "type": "string",
      "description": "YYYY-MM-DD."
    },
    "numAdults": {
      "type": "integer",
      "description": "Default 2."
    },
    "numChildren": {
      "type": "integer"
    },
    "numInfants": {
      "type": "integer"
    },
    "numDogs": {
      "type": "integer",
      "description": "Dogs in the party. Affects availability at dog-friendly sites; not a separate charge here."
    },
    "limit": {
      "type": "integer",
      "description": "1–25, default 10."
    },
    "after": {
      "type": "string",
      "description": "Pagination cursor from a previous search."
    }
  },
  "additionalProperties": false
}

Full facts about one HolidayFox destination: description, location, amenities, restrictions, check-in/out times, cancellation policy, whether it confirms instantly or by request, and every accommodation type with its size, sleeps, minimum stay and price. Data is live from the HolidayFox booking system.

{
  "type": "object",
  "properties": {
    "destinationId": {
      "type": "string",
      "description": "From search_stays, e.g. \"dest-MGaRjAwxGUrG\"."
    },
    "checkinDate": {
      "type": "string",
      "description": "YYYY-MM-DD. With checkoutDate, prices each unit for that stay."
    },
    "checkoutDate": {
      "type": "string",
      "description": "YYYY-MM-DD."
    },
    "numAdults": {
      "type": "integer"
    },
    "numChildren": {
      "type": "integer"
    },
    "numInfants": {
      "type": "integer"
    },
    "numDogs": {
      "type": "integer",
      "description": "Dogs in the party. Affects availability at dog-friendly sites; not a separate charge here."
    }
  },
  "required": [
    "destinationId"
  ],
  "additionalProperties": false
}

Check which dates are free. With destinationId alone it returns the site-wide availability calendar. With accommodationTypeId it returns per-date availability and the party-adjusted nightly price for that one unit. Dates are YYYY-MM-DD and the window is limited to 120 days. Returns availability and nightly prices only; the full stay total comes from get_quote.

{
  "type": "object",
  "properties": {
    "destinationId": {
      "type": "string"
    },
    "accommodationTypeId": {
      "type": "string",
      "description": "Optional — narrows to one unit type."
    },
    "startDate": {
      "type": "string",
      "description": "YYYY-MM-DD"
    },
    "endDate": {
      "type": "string",
      "description": "YYYY-MM-DD"
    },
    "numAdults": {
      "type": "integer"
    },
    "numChildren": {
      "type": "integer"
    },
    "numInfants": {
      "type": "integer"
    },
    "numDogs": {
      "type": "integer",
      "description": "Dogs in the party. Affects availability at dog-friendly sites; not a separate charge here."
    }
  },
  "required": [
    "destinationId",
    "startDate",
    "endDate"
  ],
  "additionalProperties": false
}

Read published guest reviews for a HolidayFox destination — star ratings, what guests said, and any reply from the owner. Returns an average rating and the most recent reviews.

{
  "type": "object",
  "properties": {
    "destinationId": {
      "type": "string",
      "description": "From search_stays or get_listing_details."
    },
    "limit": {
      "type": "integer",
      "description": "Max reviews to return, 1–10, default 5."
    }
  },
  "required": [
    "destinationId"
  ],
  "additionalProperties": false
}

List the optional extras a specific accommodation type offers — things like firewood, a hot-tub session, an extra guest, or breakfast — with their prices. Returns product ids accepted by get_quote as `addons`.

{
  "type": "object",
  "properties": {
    "destinationId": {
      "type": "string"
    },
    "accommodationTypeId": {
      "type": "string",
      "description": "From search_stays or get_listing_details."
    }
  },
  "required": [
    "destinationId",
    "accommodationTypeId"
  ],
  "additionalProperties": false
}

Get the authoritative total price for a specific stay directly from the HolidayFox booking system, including any length-of-stay discount and any optional extras passed in `addons`. Returns a quote id for begin_checkout, so the checkout total matches this quote, extras included. Does not hold the dates or make a booking.

{
  "type": "object",
  "properties": {
    "accommodationTypeId": {
      "type": "string",
      "description": "From search_stays or get_listing_details."
    },
    "checkinDate": {
      "type": "string",
      "description": "YYYY-MM-DD"
    },
    "checkoutDate": {
      "type": "string",
      "description": "YYYY-MM-DD"
    },
    "numAdults": {
      "type": "integer"
    },
    "numChildren": {
      "type": "integer"
    },
    "numInfants": {
      "type": "integer"
    },
    "quantity": {
      "type": "integer",
      "description": "Number of units, default 1."
    },
    "addons": {
      "type": "array",
      "description": "Optional extras to include, from list_addons. The quoted total includes them.",
      "items": {
        "type": "object",
        "properties": {
          "productId": {
            "type": "string"
          },
          "quantity": {
            "type": "integer",
            "description": "Default 1."
          }
        },
        "required": [
          "productId"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "accommodationTypeId",
    "checkinDate",
    "checkoutDate",
    "numAdults"
  ],
  "additionalProperties": false
}

Produce the secure HolidayFox checkout link for a quote. The guest opens the link and pays on holidayfox.com. This tool takes no payment and does not confirm a booking.

{
  "type": "object",
  "properties": {
    "destinationId": {
      "type": "string"
    },
    "accommodationTypeId": {
      "type": "string"
    },
    "quoteId": {
      "type": "string",
      "description": "The quote id returned by get_quote."
    },
    "checkinDate": {
      "type": "string",
      "description": "YYYY-MM-DD — must match the quote."
    },
    "checkoutDate": {
      "type": "string",
      "description": "YYYY-MM-DD — must match the quote."
    },
    "numAdults": {
      "type": "integer"
    },
    "numChildren": {
      "type": "integer"
    },
    "numInfants": {
      "type": "integer"
    }
  },
  "required": [
    "destinationId",
    "accommodationTypeId",
    "quoteId",
    "checkinDate",
    "checkoutDate",
    "numAdults"
  ],
  "additionalProperties": false
}

Send a guest's enquiry to the site owner by email; the owner replies to the guest directly. Suited to sold-out dates, questions the listing details leave open, and request-to-book sites. Requires the guest's name, email address and message.

{
  "type": "object",
  "properties": {
    "destinationId": {
      "type": "string",
      "description": "The site the enquiry is about."
    },
    "guestName": {
      "type": "string",
      "description": "The guest's name, as they gave it."
    },
    "guestEmail": {
      "type": "string",
      "description": "The guest's email, so the owner can reply. Must be a real address the guest gave you."
    },
    "message": {
      "type": "string",
      "description": "The enquiry in the guest’s words — dates, party, and the specific question."
    },
    "checkinDate": {
      "type": "string",
      "description": "Optional YYYY-MM-DD the enquiry is about."
    },
    "checkoutDate": {
      "type": "string",
      "description": "Optional YYYY-MM-DD."
    },
    "numAdults": {
      "type": "integer"
    },
    "numChildren": {
      "type": "integer"
    },
    "phone": {
      "type": "string",
      "description": "Optional phone number, only if the guest offered it."
    }
  },
  "required": [
    "destinationId",
    "guestName",
    "guestEmail",
    "message"
  ],
  "additionalProperties": false
}