# Hora Valencia

> Hora sells the idle hours of hotel spaces in Valencia, Spain: rooftop pools, lobby workspaces, meeting rooms, spas, gyms and night kitchens, by the hour or by the day. Guests pay the hotel on arrival. Spaces marked is_example=true are pilot examples.

## Find spaces
GET /api/listings
Returns a JSON array. Each space has: slug (use it to book), category, title, area (Valencia neighbourhood), description, open_hour and close_hour (24h, Valencia time; the window may cross midnight), unit ("day" or "hour"), per ("person" or "space"), price (EUR), capacity, includes, photo_url.

## Book
POST /api/book
Content-Type: application/json
Body:
{
  "p_listing": "<slug>",
  "p_date": "YYYY-MM-DD",            // today up to 90 days ahead
  "p_start_hour": 12,                 // integer hour inside the space's window
  "p_duration_hours": null,           // integer for unit "hour"; null for unit "day"
  "p_guests": 2,                      // 1 to capacity
  "p_name": "Full name of the guest",
  "p_email": "guest@example.com",
  "p_note": null,                     // optional
  "p_via_agent": true
}
Success returns booking_id, status "requested", the estimate in EUR and the next step. Errors return a JSON object with a human-readable "message" (for example a time outside opening hours).

Bookings are requests: Hora confirms with the hotel and emails the guest, usually within a few hours. Always confirm the space, date, time, number of people and the guest's email with the person before you book.

## Humans
Guests: / · Hotels: /hotels.html