Hotelbeds is a bedbank headquartered in Spain. Vervotech connects to its Hotelbeds APItude and maps every property to canonical IDs, so you call Hotelbeds alongside 78+ other suppliers through one REST endpoint.
Hand-rolling the Hotelbeds APItude integration takes weeks: XML schema mapping, content normalization, ID reconciliation against every other supplier you already ship. Vervotech does that work once, and keeps it fresh.
The Hotelbeds API, marketed by HBX Group as APItude, is the largest B2B hotel bedbank in the world. One integration reaches around 173,000 mapped hotels across 185 markets, and the same account also unlocks Activities and Transfers APIs from the same operator. APItude replaces the older Hotelbeds SOAP 0.2 endpoints and is the current recommended way to integrate.
Vervotech consumes the Hotelbeds Booking API and Content API on the same footing as 400+ other hotel suppliers. You call one Vervotech REST endpoint. We handle the Api-key + X-Signature authentication, the checkRate rate token life cycle, the daily content refresh from the Content API, and the cancellation-policy schema. Your rooms and rates come back with canonical Vervotech hotel IDs, so a Hotelbeds property is instantly comparable to the same hotel from Expedia Rapid, TBO Holidays, WebBeds, or any other supplier in your stack.
Hotelbeds at a glance
- Type
- bedbank
- Headquartered
- Spain
- Founded
- 1999
- Inventory
- 180000+ hotels
- API
- Hotelbeds APItude
- Regions
- Global
World's largest bedbank providing B2B hotel distribution across 185 countries via open REST APIs
Hotelbeds APItude endpoints, mapped through Vervotech
The Hotelbeds Hotels API Suite has three parts: Booking API (search and confirm), Content API (static hotel data), and Cache API (bulk price files). Vervotech reads every one of them and returns the merged result through a single REST call.
| Endpoint | What it does |
|---|---|
Hotels availability (POST /hotel-api/1.0/hotels) | Live search by destination code, hotel codes, geolocation, dates, and occupancy. Vervotech returns Hotelbeds rates side by side with peer suppliers on the same canonical hotel ID. |
checkRates (POST /hotel-api/1.0/checkrates) | Rate token verification before booking. Vervotech calls checkRates on your behalf and returns MATCHED or the new rate before it commits the booking. |
Booking confirm (POST /hotel-api/1.0/bookings) | Places the reservation. Vervotech's booking endpoint proxies to Hotelbeds with the rate token and returns the Hotelbeds reference plus a Vervotech canonical booking ID. |
Booking list (GET /hotel-api/1.0/bookings) | Retrieve confirmed bookings by date range or reference. Vervotech unifies this with booking history from every other supplier. |
Booking detail (GET /hotel-api/1.0/bookings/{ref}) | Full itinerary retrieval. Vervotech surfaces confirmation numbers, room details, and cancellation deadlines via one canonical booking-retrieval call. |
Booking cancel (DELETE /hotel-api/1.0/bookings/{ref}) | Cancellation. Vervotech maps Hotelbeds cancellation policies to our canonical rate-rule schema so your UI stays consistent. |
Hotel content (GET /hotel-content-api/1.0/hotels) | Static content, up to 1000 hotels per page. Vervotech runs the daily lastUpdateTime differential sync so you never touch the paging. |
Content descriptions (facilities, boards, categories, chains, destinations) | Reference tables for facility codes, board types, categories, and chains. Vervotech unifies these vocabularies with 3M+ properties from every other supplier. |
Hotel Cache API | Bulk price and availability files for offline analysis. Vervotech ingests these to power rate benchmarks and Profit Maximizer. |
How Vervotech maps Hotelbeds
- Ingest. We pull static and dynamic content directly from Hotelbeds APItude on a daily refresh cycle.
- Normalize. Schema, currency, and language are unified to Vervotech's canonical model.
- Map. Properties are resolved to canonical hotel IDs across every supplier you connect, at 99.998% accuracy on 3M+ properties.
- Deduplicate rooms. Identical room types across suppliers collapse to one canonical room.
- Expose. One REST endpoint returns the merged, deduplicated inventory ready for booking.
How you connect Hotelbeds through Vervotech in 5 steps
- Step 1. Sign up for Vervotech. Create a Vervotech account and grab your REST API key. 7-day free trial, no credit card.
- Step 2. Enable Hotelbeds in your dashboard. Toggle Hotelbeds on. If you already have APItude credentials (Api-key + secret), plug them into the Vervotech dashboard. If not, Vervotech can help route the Hotelbeds partnership request through developer.hotelbeds.com.
- Step 3. Sync property IDs. Vervotech maps every Hotelbeds hotel code to a canonical Vervotech hotel_id. You get a CSV or an API endpoint to reconcile your existing IDs with ours before switching traffic.
- Step 4. Call the unified shopping endpoint. One HTTPS POST returns rates from Hotelbeds, Expedia Rapid, WebBeds, TBO, and every other supplier you have enabled. Compare margins per room across suppliers in a single JSON response.
- Step 5. Book via the Vervotech booking API. Pass the rate token. Vervotech follows the Hotelbeds checkRates and bookings call chain on your behalf, returns the reference number, and stores the cancellation policy on the canonical booking record.
Hotelbeds XML API, translated to REST
Most legacy hotel supplier APIs, including Hotelbeds, expose XML over SOAP or plain HTTPS POST. Every field is nested inside supplier-specific elements, dates are in supplier-specific formats, and rate rules are buried inside repeating groups you have to unwind before you can even read them.
Vervotech reads the Hotelbeds XML directly, parses the schema, normalizes fields to a canonical JSON model, and exposes the result as a single REST endpoint. You never touch the XML. If the Hotelbeds schema changes, we absorb the change on our side without breaking your integration.
- No SOAP envelopes, no XML namespaces, no XSD parsing on your side
- Canonical hotel and room IDs across every supplier you connect
- Currency, language, and date fields already unified
- Rate rules, cancellation policies, and inclusions flattened into readable JSON
Hotelbeds APItude eligibility and certification
Hotelbeds APItude requires a signed distribution agreement plus a mandatory certification pass before production credentials are issued. Test credentials against api.test.hotelbeds.com are free to develop against. The certification checks your workflow across Availability, CheckRate, Confirmation, Content, Voucher, and Live environment. Vervotech-mapped customers do not need to run this certification separately for the Vervotech integration; only your Hotelbeds account needs to be certified once.
Direct Hotelbeds APItude vs Hotelbeds via Vervotech
| Concern | Direct integration | Through Vervotech |
|---|---|---|
| Suppliers reachable | Hotelbeds only | Hotelbeds + 400+ others through one endpoint |
| Auth | Api-key + rolling X-Signature (SHA-256) on every call | One Vervotech API key, we sign every Hotelbeds request |
| Content sync | Paged 1000-per-request initial load + daily lastUpdateTime differential | Handled by Vervotech, exposed as canonical hotel objects |
| Rate tokens | checkRates required before booking, tokens expire | Managed transparently, we call checkRates on your behalf |
| Cross-supplier price shop | Not possible from Hotelbeds alone | Direct, on shared canonical hotel + room IDs |
| Certification | Mandatory before live access | Only your Hotelbeds account, once. Vervotech integration inherits it. |
Common use cases
- OTAs consolidating wholesale + direct + bedbank inventory into a single searchable index
- Travel agencies looking for best-rate retrieval across multiple suppliers in <500ms
- Corporate booking tools standardizing on a single hotel ID schema across vendors
- Hotel rate intelligence platforms tracking competitor pricing across distribution channels
- Tour operators packaging hotel + flight + activity with deduplicated property catalogs
Frequently asked questions
What is the Hotelbeds hotel API?
- The Hotelbeds APItude is Hotelbeds's programmatic interface for searching, pricing, and booking hotel inventory. It returns static content, live rates, and availability for 180000+ hotels of properties.
How does Vervotech integrate with Hotelbeds?
- Vervotech ingests Hotelbeds on a daily refresh, normalizes the schema, and maps every property to canonical hotel IDs that match all your other suppliers. You hit one REST endpoint instead of integrating Hotelbeds directly.
How long does a Hotelbeds integration take through Vervotech?
- Most customers are live in days, not weeks. There is no XML mapping work and no per-supplier ID reconciliation, because Vervotech already maintains the canonical schema across 400+ suppliers.
Does the Hotelbeds XML API expose all inventory that the REST API returns?
- Vervotech reads directly from Hotelbeds's primary API feed, so you get the same static content, live rates, availability, and booking capabilities you would get integrating the Hotelbeds XML natively. The difference is you consume it as REST JSON, and the same request pattern works across every other supplier in your stack.
What happens if the Hotelbeds XML schema changes?
- Vervotech absorbs the schema change on our side. Your integration keeps working. Our team maintains the schema-to-canonical mapping continuously, which is the single largest hidden cost in every in-house XML API integration.
Can I rate-shop Hotelbeds against other suppliers?
- Yes. Because Hotelbeds properties share canonical IDs with every other supplier in Vervotech, you can compare rates, route bookings to the best margin, and rebook automatically when prices drop with Profit Maximizer.
How much does it cost?
- Hotel Mapping starts at $499 a month with a 7-day free trial. Package discounts run up to 50% off when you bundle multiple suppliers.
Is APItude the same as the old Hotelbeds API?
- APItude is the current suite of Hotelbeds REST APIs, launched in 2020 to replace the older SOAP interface. Vervotech is on APItude, so you get the current schema and content.
How is Hotelbeds authentication handled?
- Hotelbeds APItude uses an Api-key header plus a rolling X-Signature computed as SHA-256 of api-key + secret + UTC timestamp. Vervotech handles this signing on every request so you never see the secret in transit from your side.
Can I use Hotelbeds through Vervotech without Hotelbeds credentials?
- You need your own Hotelbeds APItude account for compliance and commercial reasons, but Vervotech operates the technical integration on top of your credentials. Your commercial relationship stays with Hotelbeds; Vervotech charges only for mapping and aggregation.
Does Vervotech expose Hotelbeds Activities and Transfers?
- The Vervotech hotel API focuses on lodging. Activities and Transfers from Hotelbeds are on the roadmap but not yet exposed through the unified endpoint.
How much of the Hotelbeds portfolio does Vervotech map?
- Vervotech maps essentially the full HBX Group hotel portfolio to canonical Vervotech hotel IDs. Coverage is monitored continuously as HBX publishes new inventory through the Content API's lastUpdateTime feed.
Official Hotelbeds APItude documentation
Start integrating in minutes, not weeks
7-day free trial. No credit card required. Hotel Mapping starts at $499 a month, with package discounts up to 50% off when you bundle suppliers.
Product Tour