{
  "specVersion": "1.0",
  "entries": [
    {
      "@context": "https://agenticresourcediscovery.org/context/v1",
      "@id": "urn:air:fivestar.ie:api:guest-listings",
      "identifier": "urn:air:fivestar.ie:api:guest-listings",
      "displayName": "Five Star Guest Listing API",
      "type": "application/openapi+json",
      "url": "https://fivestar.ie/.well-known/fivestar-agent-api.json",
      "description": "A public, read-minimized API for searching published Five Star listings, checking selected-listing availability, handing guests to direct booking, and submitting enquiries for enquiry-only listings.",
      "capabilities": [
        "search_listings",
        "check_listing_availability",
        "direct_booking_handoff",
        "submit_listing_enquiry"
      ],
      "tags": [
        "fivestar",
        "holiday-rentals",
        "listings",
        "availability",
        "booking-handoff",
        "enquiries",
        "openapi"
      ],
      "representativeQueries": [
        "Find published listings near the beach in Ireland for 8 October to 16 October.",
        "Find a listing with a sea view that sleeps four.",
        "Is listing 153640 available for these dates?",
        "Submit an enquiry for this enquiry-only listing."
      ],
      "version": "1.0.0",
      "updatedAt": "2026-10-08T00:00:00Z",
      "metadata": {
        "publisher": "Five Star International",
        "visibility": "public",
        "protocol": "HTTPS REST",
        "openapi": "https://fivestar.ie/.well-known/fivestar-agent-api.json",
        "apiBase": "https://fivestar.ie/accounts/api/agent/v1",
        "authenticationRequired": false,
        "authentication": "Read endpoints are public. The enquiry endpoint is protected by strict validation, explicit consent, mandatory idempotency, request-size limits, email and IP controls, and rate limiting.",
        "dataMinimization": "Responses contain only public listing content, location labels, availability outcomes, booking handoff URLs, and an opaque enquiry confirmation reference. They never contain CRM records, owner details, guest details, bookings, or blocked-date details.",
        "writeSafety": "The enquiry endpoint accepts only enquiry-only listings and delegates creation to the existing CRM enquiry and notification workflow. It does not create or modify bookings."
      }
    }
  ]
}