API for AI Travel Agents

F1 Penthouse Florence is fully machine-readable. AI agents can query availability, get pricing, and create reservation holds without scraping.

Core endpoints

Base URL: https://lacorsasuit.com/api/v1

GET /property — Full property data, amenities, pricing, policies, reviews
GET /availability?check_in=YYYY-MM-DD&check_out=YYYY-MM-DD&guests=2 — Availability + price breakdown
POST /quote — Detailed price quote (JSON body)
POST /reservations — Create reservation hold (blocks dates, returns payment info)
GET /reservations/{id} — Reservation status

Example: GET /api/v1/availability

{
  "check_in": "2026-05-10",
  "check_out": "2026-05-17",
  "guests": 4,
  "available": true,
  "nights": 7,
  "price_breakdown": {
    "nights": 7,
    "nightly_avg": 350,
    "accommodation": 2450,
    "discount_label": "Weekly discount",
    "discount_percent": 10,
    "discount_amount": -245,
    "cleaning_fee": 150,
    "city_tax": 98,
    "city_tax_note": "Approx. €3.50/person/night, max 7 nights",
    "total": 2453,
    "currency": "EUR"
  }
}

Quick start for AI agents

1. Get property data

GET /api/v1/property

Returns full property details: capacity, amenities, pricing rules, policies, reviews, coordinates.

2. Check availability

GET /api/v1/availability
  ?check_in=2026-06-01
  &check_out=2026-06-08
  &guests=4

3. Create reservation

POST /api/v1/reservations
{
  "check_in": "2026-06-01",
  "check_out": "2026-06-08",
  "guests": 4,
  "guest": { ... }
}

4. MCP Server

For Claude Desktop and compatible agents, use our MCP server for tool-call-based access.

MCP server docs →

Discovery files

OpenAPI Spec
JSON schema for all endpoints
/api/openapi.json
robots.txt
AI crawler permissions
/robots.txt
sitemap.xml
Full page index
/sitemap.xml
AI Plugin Manifest
ChatGPT / OpenAI plugin
/.well-known/ai-plugin.json
Agent Card
A2A protocol discovery
/.well-known/agent-card.json