# api.villas — the villa & short-stay lodging rail's machine face

The Booking record (schema.org Offer/Reservation grain), the villa/short-stay
Property inventory, night-audit reports, and guest folios for independent
lodging operators (NAICS 721 sub-niche), served as one substrate with two
plies: read the record collections (data face) or operate the same
collections as a Booking/PMS system of record (headless face). Same
envelopes, same rate rows, one definition.

Everything below answers today, keyless. EVERY record on this sandbox is
labeled example data (simulated): the row's route is first-party
booking/night-audit capture at the rail, that rail is not yet built, and
public rate data is a lane this property deliberately does not touch — so
nothing here is, or pretends to be, real market inventory.

## Quickstart

```sh
curl https://api.villas/bookings                        # keyless first value — typed OK envelope
curl https://api.villas/bookings?status=checked-in      # branch on the query
curl https://api.villas/properties?type=villa           # the short-stay inventory grain (labeled demo units)
curl https://api.villas/night-audit-reports             # the typed operational artifact (the sector wedge)
curl https://api.villas/pricing                         # the Pricing Document (402-shaped stub — no billing occurs)
```

## Faces

- card: https://api.villas/.well-known/agents.json
- openapi: https://api.villas/openapi.json
- pricing: https://api.villas/pricing
- icp: https://api.villas/icp.json
- substrate: https://api.villas/substrate.json
- verify: https://api.villas/verify

## Machine surfaces

- Capability card (AXP probe manifest): https://api.villas/.well-known/agents.json
- OpenAPI 3.1 contract: https://api.villas/openapi.json
- Pricing Document: https://api.villas/pricing
- icp.json (agent classes): https://api.villas/icp.json
- This file: https://api.villas/llms.txt
- Conformance (independent verifier): https://api.qa/api.villas
