R2 Connect API
Connect your accounting software, point of sale or reporting tool to a business running on R2. Read-only REST API with per-resource permissions.
R2 Connect API gives you read access to the operational data of a business running on R2: reservations, orders, payments, customers and catalog. It exists so an external system — accounting, point of sale, business intelligence — can work with real data without anyone typing it twice.
The business owner generates an access key from their dashboard and picks exactly what your integration may read. They can revoke it at any time, and their activity log shows every request you made.
The essentials#
| Base URL | https://api.r2-os.com/api/connect/v1 |
| Authentication | Access key in the Authorization header |
| Format | JSON on every response |
| Methods | GET — version 1 is read-only |
| Rate limit | 600 requests per minute, per key |
| Version | v1, included in the path |
What you can read#
| Resource | What it is for |
|---|---|
| Reservations | Lodging stays with nights, guests, charges, taxes and balance. |
| Orders | Every commercial transaction: restaurant, store, experiences and lodging. |
| Payments | Charges and their method, for accounting reconciliation. |
| Customers | Customer and guest directory with their spending history. |
| Catalog | Rooms, dishes and products with their prices. |
One model, every vertical
R2 has no separate systems for hotels, restaurants and experiences: everything sellable is a catalog item and every transaction is an order. That means the same integration serves a boutique hotel and a restaurant, with no separate code path.
Next step#
Follow the quickstart to make your first request in two minutes.