Veridien now has a public REST API. The same engine that powers our own booking flows is available for you to build on — a custom booking engine, a guest mobile app, a loyalty integration, or any back-office automation.
It is a plain HTTP/JSON interface. You authenticate with a per-property API key, send and receive snake_case JSON, and rely on standard status codes and a single, uniform error envelope. Every key is scoped, so it can only do what you grant it, on the one property it belongs to.
What's new
- Per-property API keys — create, scope, and revoke keys under Settings → API Keys. Keys are shown once and stored only as a hash.
- Scoped access — twelve granular scopes (for example
availability:read,reservations:write,folio:write) gate every endpoint, including a separateguests:read:piiscope for sensitive guest data. - The full reservation lifecycle — search availability, price a stay with visibility-gated rates, register or link a guest, hold inventory, confirm a paid reservation, and post folio charges.
- Loyalty — read a guest's balance and tier, redeem points, and earn automatically on confirmed stays.
- Safe retries — mutating requests accept an
Idempotency-Key, so a network retry never double-books or double-charges. Reservation confirmation is additionally idempotent on its payment reference. - Predictable errors — every failure returns a typed envelope with a stable
code, an optionalparam, and arequest_id. - OpenAPI 3.1 schema — a machine-readable description of every endpoint is served at
/api/v1/openapi.jsonfor generating typed clients.
The resources
| Area | What you can do |
|---|---|
| Catalog | Read the property, room types, availability, and eligible rate plans |
| Guests | Register or link guests, read and update profiles, read loyalty |
| Reservations | Hold inventory, confirm reservations, list and read reservations, cancel |
| Folios | Read a reservation's bill and post charges to it |
| Loyalty | Read balances and tiers, redeem points |
Full reference, a quickstart, and copy-paste examples live in the API documentation. The base URL is https://veridien.app/api/v1.