You can now build directly on Veridien. The same engine that powers our own booking flows is open to you: a custom booking engine, a guest mobile app, a loyalty integration, or any back-office automation.
It's 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.
- 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.
| 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.