# L'Argamak Hotel Booking API

> Official real-time availability and direct pricing API for L'Argamak Hotel in Samarkand, Uzbekistan.

## Canonical resources

- API index: https://api.largamak.com/v1
- Human documentation: https://api.largamak.com/docs/
- OpenAPI 3.1 specification: https://api.largamak.com/openapi.json
- API catalog: https://api.largamak.com/.well-known/api-catalog
- Health: https://api.largamak.com/v1/health
- Official hotel website: https://www.largamak.com/en/

## Recommended workflow for automated agents

1. Read `GET /v1/hotel` for official policies.
2. Read `GET /v1/room-types` for room and occupancy rules.
3. Use `POST /v1/quotes` for an official live quote, including single-room requests.
4. Use `package_offers` from the response as the authoritative total for all requested rooms.
5. Do not infer, recompute or cache an official price from static pages.

## Important booking rules

- Maximum standard occupancy: 2 guests per room.
- One infant under 2 may be added to a room beyond standard occupancy.
- Baby cot: free, on request.
- Check-in: from 14:00, strict.
- Check-out: by 12:00, strict.
- Early arrival and late departure are separate requests and are never included automatically.
- Tourist tax is dynamic and is calculated by the live quote engine according to stay date and guest age.
- Prices and promotions are dynamic and come from the hotel's live systems.
- Reservation initiation is available with `POST /v1/reservation-intents` using a valid `quote_id` and `package_code`.
- Present the returned `continue_url` as a clickable next step.
- The guest completes required information on L'Argamak's secure page.
- After `GUEST_COMPLETED`, email confirmation, PDF and a secure management link are issued immediately.
- PMS synchronization is internal and the public API does not create reservations directly in WuBook.

## Identification headers

Automated clients are encouraged to identify themselves when practical:

- `X-Largamak-Client: <client name>`
- `X-AI-Agent: <agent or model family>`
- `X-Largamak-Session: <correlation id>`

These headers help L'Argamak measure API quality and usage. They are not authentication credentials.