{
  "name": "api.villas",
  "description": "Lodging & Accommodation (NAICS 721, villa/short-stay sub-niche) substrate: the Booking record (schema.org Offer/Reservation), villa/short-stay Property inventory, night-audit reports, and guest folios — data face and headless Booking/PMS face from one definition, anonymous sandbox as the universal floor. Wave-zero surface; every sandbox record is labeled example data.",
  "interfaces": {
    "http": [
      {
        "method": "GET",
        "url": "https://api.villas/bookings"
      },
      {
        "method": "GET",
        "url": "https://api.villas/pricing"
      },
      {
        "method": "GET",
        "url": "https://api.villas/openapi.json"
      },
      {
        "method": "GET",
        "url": "https://api.villas/llms.txt"
      },
      {
        "method": "GET",
        "url": "https://api.villas/offer"
      },
      {
        "method": "GET",
        "url": "https://api.villas/properties"
      },
      {
        "method": "GET",
        "url": "https://api.villas/night-audit-reports"
      },
      {
        "method": "GET",
        "url": "https://api.villas/folios"
      },
      {
        "method": "GET",
        "url": "https://api.villas/icp.json"
      },
      {
        "method": "GET",
        "url": "https://api.villas/substrate.json"
      },
      {
        "method": "GET",
        "url": "https://api.villas/verify"
      },
      {
        "method": "GET",
        "url": "https://api.villas/projection.json"
      }
    ],
    "mcp": {
      "url": "https://api.villas/mcp",
      "transport": "streamable-http",
      "tools": [
        "listBookings",
        "getBooking",
        "listProperties",
        "getProperty",
        "listNightAuditReports",
        "getNightAuditReport",
        "listFolios",
        "createBooking",
        "cancelBooking",
        "runNightAudit"
      ]
    }
  },
  "openapi": "https://api.villas/openapi.json",
  "llms": "https://api.villas/llms.txt",
  "links": {
    "openapi": "https://api.villas/openapi.json",
    "llms": "https://api.villas/llms.txt",
    "pricing": "https://api.villas/pricing",
    "icp": "https://api.villas/icp.json",
    "verify": "https://api.villas/verify",
    "conformance": "https://api.qa/api.villas"
  },
  "g2": {
    "$context": "https://schema.org.ai",
    "$type": "G2",
    "substrate": "lodging",
    "motion": "B2A",
    "icp": {
      "companyTypes": [
        "villa/vacation-rental manager",
        "small independent hotel"
      ],
      "industries": [
        "NAICS 721 (7211 traveler accommodation)"
      ],
      "jobTypes": [
        "property manager",
        "night auditor",
        "revenue manager"
      ],
      "demandSide": "agent-intermediated stays: guest-side demand reaches this rail through agents (B2A2C free-rider), below the chain/OTA incumbency line [register row ICP hint, verbatim in substance]"
    },
    "personas": [
      {
        "role": "property manager",
        "reads": "properties, bookings, folios",
        "buys": "nothing here yet — wave zero"
      },
      {
        "role": "night auditor",
        "reads": "night-audit reports, folios",
        "buys": "nothing here yet — wave zero"
      },
      {
        "role": "revenue manager",
        "reads": "night-audit reports (occupancy, ADR, room revenue)",
        "buys": "nothing here yet — wave zero"
      },
      {
        "role": "autonomous agent",
        "reads": "everything on this face, keyless",
        "onboarding": "B2A — no OAuth, no card; 402-shaped boundary (stub)"
      }
    ],
    "agentClasses": [
      "machine (id.org.ai grain)",
      "machine (unattributed)"
    ],
    "firstCustomer": "none claimable — the first-party capture rail is not built at wave zero (C-class, batch 7); the sandbox corpus is labeled synthetic seed, not a customer"
  },
  "monetization": {
    "offers": [
      {
        "id": "b2a-metered-stub",
        "title": "Metered access (402-shaped stub — no live settlement at wave zero)",
        "price": {
          "model": "metered",
          "hardCeiling": 25,
          "unit": "usd-per-month"
        }
      }
    ],
    "probe": {
      "method": "GET",
      "url": "/offer"
    }
  },
  "probes": {
    "keyless": {
      "url": "/bookings"
    },
    "knownEmpty": [
      {
        "url": "/bookings?status=none"
      },
      {
        "url": "/bookings?property=none"
      }
    ],
    "knownForbidden": [
      {
        "url": "/bookings?scope=admin"
      },
      {
        "url": "/bookings?scope=internal"
      }
    ],
    "pricing": {
      "url": "/pricing"
    },
    "overCeiling": {
      "url": "/bookings",
      "param": "spend"
    }
  }
}