API & Developers

Programmatic access to your revenue stack.

REST API for forecasts, decision-journal exports, rate publishes, and webhook events. Stable contracts, signed payloads, full audit trail — built for ownership groups, BI teams, and platform integrators.

Overview

Built for ownership groups, BI teams, and integrators

Most ARIO customers never touch the API — the operator UI, OHIP write-back and Channel-Manager publish handle the daily workflow end-to-end. The API exists for ownership groups that want forecast feeds in their data warehouse, BI teams that want the decision journal exported nightly, and platform integrators building bespoke tooling on top of the Revenue OS.

Access by request, under contract

API keys are issued only to customers on the Standard, Premium, or Enterprise tier, against a signed Data & API Addendum. We do not publish a public sandbox — every key is bound to a named property and rate-limited per environment.

Request API access

Forecast endpoints

Pull demand and revenue forecasts at any granularity — by-room-type, by-segment, by-day, up to a 365-day horizon. Stable JSON contracts, ETag-based caching, includes confidence intervals.

Decision journal export

Every pricing decision, every override, every group quote — exportable as a hash-chained, tamper-evident log. CSV, JSON, or streamed via webhook.

Rate publish API

Push approved rates back into your PMS or Channel Manager from the same audited payload that the operator approved. Idempotent, retried, every call logged.

Pace & pickup feeds

Real-time pace, OTB, and pickup deltas — exposed both as polled endpoints and streamed via signed webhook. Ideal for ownership dashboards.

Webhook events

Subscribe to high-signal events: rate.published, decision.committed, group.quoted, autopilot.flagged. Every payload signed and replay-safe.

Multi-property roll-up

Boutique groups can scope a single key to all properties or sub-scope per property. Aggregate forecasts roll up across the portfolio without N+1 calls.

Authentication

Signed requests, scoped keys, no shared secrets

Every request is authenticated with a long-lived API key bound to a property scope, paired with a per-request signature over the body and timestamp. Keys are rotated on a schedule defined in your contract, revocable instantly, and never travel through query strings.

Property-scoped keys

Every key is bound to one or more property IDs. Cross-tenant access is structurally impossible — a London key cannot read a Paris forecast.

Signed payloads

Bodies and timestamps are signed using industry-standard HMAC. Replay protection is enforced via timestamp skew limits.

Audit-traced access

Every API call is recorded in the same tamper-evident journal as operator actions. You can reconstruct exactly what your integration did, when, and with what payload.

Request example

Pull a 30-day forecast

Stable JSON, ETag caching, confidence intervals included. Same payload the Cockpit renders.

GET /v1/properties/{propertyId}/forecast
JSON · 200 OK
// curl example — Authorization header carries the signed key curl -X GET https://api.ario.io/v1/properties/PRP_001/forecast \ -H "Authorization: Bearer ario_live_..." \ -H "X-Ario-Signature: t=1714060800,v1=..." \ -H "Accept: application/json" \ -d '{ "horizon": 30, "granularity": "daily", "segment": "all" }' // Response { "propertyId": "PRP_001", "horizon": 30, "generatedAt": "2026-04-26T08:00:00Z", "forecast": [ { "date": "2026-04-27", "demand": 87.4, "adr": 214.50, "revenue": 18747.30, "confidence": { "lo": 82.1, "hi": 92.8 } } // ... 29 more days ] }
Endpoints

Available endpoints

A complete reference is provided in the API addendum at contract signing. The table below summarises the surface area.

Method
Path
Description
Tier
GET
/v1/properties/{id}/forecast
Demand & revenue forecast, daily granularity, up to 365d horizon.
Standard+
GET
/v1/properties/{id}/pace
Real-time pace, OTB, and pickup deltas vs same-time-last-year.
Standard+
GET
/v1/properties/{id}/journal
Decision-journal export — pricing decisions, overrides, group quotes.
Premium+
POST
/v1/properties/{id}/rates/publish
Approved rate publish back to PMS / Channel Manager. Idempotent.
Premium+
POST
/v1/properties/{id}/groups/quote
Generate a group quote with displacement maths, returns auditable PDF + JSON.
Premium+
GET
/v1/groups/{group}/rollup
Aggregated portfolio forecast across multiple properties (boutique groups).
Enterprise
POST
/v1/webhooks
Register a webhook endpoint; event subscriptions configurable per topic.
Standard+
DELETE
/v1/webhooks/{id}
Remove a webhook subscription. Hash-chained audit entry created.
Standard+
Rate limits & SLAs

Predictable limits, predictable behaviour

Every customer gets a per-key rate budget sized to their tier. Limits are exposed in response headers (X-RateLimit-Remaining, X-RateLimit-Reset). Bursts are absorbed; sustained overage queues with backoff.

60/min
Standard tier
Sufficient for nightly BI exports and ownership dashboards.
300/min
Premium tier
Headroom for hourly polling across a multi-property roll-up.
Custom
Enterprise tier
Negotiated limits, dedicated capacity, named SRE contact.
99.9%
API uptime SLA
Standard contractual SLA. Status page subscribed via RSS.

Ready to integrate?

API access is part of the Standard, Premium, and Enterprise tiers. Talk to the team about your integration and we'll issue keys with your contract.

Request API access