Easy RFP — API Reference & Methodology

Authentication

All endpoints require a valid Supabase JWT in the Authorization header:

POST https://jhihwzfikvndybbyaoul.supabase.co/rest/v1/rpc/{function_name}
Authorization: Bearer eyJhbGciOiJIUzI1NiIs...
apikey: {your_anon_key}
Content-Type: application/json

Tokens are obtained via magic-link OTP at /app/. Token TTL: 60 minutes. Use refreshSession to extend.

score_hotel_for_brief authenticated

Returns a normalized score (0–1) for a given hotel against a published brief. Includes breakdown by criterion.

Returns: {score: 0.78, breakdown: {price: 0.85, location: 0.72,...}}

For planners: how the composite score is built

The score you see next to every proposal (e.g. "78/100") is a TOPSIS multi-criteria score. TOPSIS ranks each hotel by how close it is to an ideal proposal across four criteria — by default price (35%), location (25%), MICE fit (25%), and response time (15%). You can change the weights yourself on any RFP.

The technical RPC that computes this is topsis_rank_hotels (documented just below) — but you don't need to call anything. The app does it for you on the Compare view, and the score updates live as you drag the weight sliders.

topsis_rank_hotels authenticated

TOPSIS multi-criteria ranking of hotels for a given RFP. Honors organizer-defined scoring weights and applies mice_role multipliers (event_venue 1.2x, full_service 1.0x).

Returns: ranked list with rank, topsis_score, price_score, location_score, cluster_boost, why_this_hotel array.

suggest_weights_for_rfp authenticated

AHP-lite weight suggestions based on RFP characteristics (sector, intent, attendees). Returns 4-criterion split summing to 1.0.

Returns: {price: 0.35, location: 0.25, mice_fit: 0.25, response_time: 0.15, rationale: "..."}

suggest_counter_offer authenticated

Recommends counter-offer terms based on cohort history (sector × city × pax band). Requires N≥5 comparable proposals.

predict_win_probability authenticated

9-factor heuristic returning probability that a given hotel wins a given RFP (0.0–1.0). Factors: completeness, response_rate, mice_fit, price_position, cluster_boost, intent_score, sector_match, history, recency.

detect_proposal_anomalies authenticated

Detects price outliers (z-score against cohort), duplicate proposals, and rate manipulation. Severity: low/medium/high.

compute_realistic_total_cost authenticated

Adds DDR, F&B, AV, perks to base room rate. Returns per-attendee and total. Used by Compare view.

get_hotel_dashboard_stats authenticated

Hotel-side stats: rankings 30d, response_rate, completeness_pct, RFPs received vs responded, cluster_boost current value.

dsar_export GDPR Art. 15

Returns all data Easy RFP holds about a given hotel or organizer. JSON or ZIP. Includes proposals, sends, field_facts, deltas.

request_erasure GDPR Art. 17

Initiates right-to-be-forgotten flow. Cascades delete in 5 child tables. Confirmation email required (TTL 24h).

v_proposals_csv_export authenticated

OpenTravel-compatible CSV view. Compatible with Cvent, Knowland, AventriOnArena import flows.

For planners: how "hours saved" and ROI are calculated

The "~Nh sourcing time saved" figure on your dashboard uses an industry-anchored heuristic:

Total hours × €40/h average loaded planner labor cost = labor saved. Divided by your monthly subscription cost = ROI multiplier shown in the dashboard tile.

Numbers are intentionally conservative — heavy users with multi-property RFPs typically save 2–3× more.

For planners: response rate benchmark

The "industry average ~22%" comparison shown on your Reports page is anchored to ReadyBid's 2025 hotel response rate report, which surveys typical email-only RFP outreach. Easy RFP customers typically see 35–45% response rates due to brief completeness and curated shortlists.

Your number is computed live: responded / sends × 100, where responded means the hotel returned at least one proposal artifact (rate, document, decline reason).

For planners: currency & FX handling

See the Currency & FX section below for the full reference (default ECB rates, lock-on-send, configurable corporate rates, audit trail).

Rate limits

Status & SLA

System health: easyhotelrfp.com/status · Uptime target: 99.5% · API response p95: <800ms.

Need help?

Email [email protected] · GDPR / DSAR: [email protected]