HotelBeds Hotel API Integration via Vervotech

Integration snapshot

Supplier

HotelBeds

Type

Bedbank or wholesaler

Origin country

Spain

Region

Europe

Coverage tier

Production-grade

Canonical mapping

Vervotech hotel + room IDs

Schema unification

Names, addresses, geocodes, amenities, room types, board types

Delivery

REST API, offline file sync, on-demand match

What Vervotech does for HotelBeds

• Canonical hotel IDs. Each HotelBeds property resolves to a single Vervotech hotel ID shared with every other connected supplier.
• Room-level mapping. Identical room types from HotelBeds collapse with peer suppliers' equivalents into a canonical room ID, so you can shop rates without duplicate inventory.
• Continuous refresh. Static and dynamic HotelBeds content is pulled on a recurring cycle, so newly contracted properties enter the mapped catalog without engineering work.
• One REST endpoint. Call HotelBeds content through the same Vervotech endpoint that serves the rest of your supplier mix.
• Bedbank deduplication. Where HotelBeds overlaps with peer bedbanks on the same property, Vervotech keeps a single canonical record and exposes both rate options under one listing.

How the HotelBeds integration works

1. Ingest. Vervotech pulls the HotelBeds hotel content feed on a continuous refresh cycle. Both static (hotel attributes) and structural (room and board types) data are captured.
2. Normalize. HotelBeds's schema is mapped to a canonical Vervotech model. Currency, language, geocoding, and amenity vocabularies are standardized.
3. Resolve. Every HotelBeds property is matched to a canonical Vervotech hotel ID using deterministic rules (address, geocode, name) and ML scoring trained on 3M+ properties.
4. Deduplicate rooms. Equivalent room types from HotelBeds are collapsed with peer supplier rooms into a canonical room ID.
5. Expose. HotelBeds content is reachable through one Vervotech REST endpoint, mixed with the rest of your supplier inventory.

HotelBeds in depth

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 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.

How you connect Hotelbeds through Vervotech in 5 steps

1. Step 1. Sign up for Vervotech. Create a Vervotech account and grab your REST API key. 7-day free trial, no credit card.
2. 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.
3. 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.
4. 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.
5. 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 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

Example HotelBeds response via Vervotech

Vervotech returns HotelBeds properties enriched with canonical IDs that match the same property as served by peer suppliers.

GET /v3/hotels?supplier=hotelbeds&country=sp
Authorization: Bearer YOUR_VERVOTECH_KEY

200 OK
{
  "supplier": "HotelBeds",
  "hotels": [
    {
      "vervotech_id": "vt_8f3a91...",
      "hotelbeds_id": "SUP_REF_12345",
      "name": "Example Hotel Hot",
      "address": "...",
      "geo": { "lat": ..., "lng": ... },
      "rooms": [ { "vervotech_room_id": "vrm_...", "hotelbeds_room_id": "RM_77" } ]
    }
  ]
}

Schema is illustrative. See the Hotel Mapping API documentation for the full spec.

Vervotech-mapped HotelBeds vs direct HotelBeds integration

Typical HotelBeds use cases

• OTAs and metasearch: blend HotelBeds rates with peer suppliers behind a single property listing, with no duplicates and no schema drift.
• Travel agencies and TMCs: route bookings to HotelBeds when its rate wins, fall back to alternates when it does not, all under one mapped catalog.
• Corporate travel: normalize HotelBeds content into one travel-policy view across regions and brands.
• Post-booking margin capture: watch HotelBeds and peer rates after the original booking and rebook automatically via Vervotech Profit Maximizer when a cheaper rate appears.

Related Vervotech capabilities

• Hotel Mapping API99.998% accuracy at 3M+ properties
• Room Mapping APICanonical room IDs across suppliers
• Profit MaximizerPost-booking margin capture across HotelBeds and peers
• All 153+ suppliersBrowse the full supplier network

Official Hotelbeds APItude documentation

• Hotelbeds Developer Portal (APItude) ↗
• Hotelbeds Booking API documentation ↗
• Hotelbeds Content API documentation ↗
• Hotelbeds getting-started guide ↗
• APItude certification process ↗