# Hotelbeds Hotel Booking API (slim)

> B2B hotel distribution API for availability, rates, bookings, cancellations and property content.

- Full: https://www.anchorterminal.com/tools/hotelbeds.md (~5,350 tokens) · this version ~1,330 tokens · JSON https://www.anchorterminal.com/tools/hotelbeds.json · canonical https://www.anchorterminal.com/tools/hotelbeds
- Index: https://www.anchorterminal.com/llms.txt · API: https://www.anchorterminal.com/api/v1/index.json · Updated: 2026-10-04

**F · 36.7/100 · rank #435 of 452 · #7 in Travel & booking · not agent-ready · confidence medium**


Assessment: Free evaluation key on registration, no card and no sales call. 50 requests a day on evaluation, and the 51st returns a 403.

## Facts

- Kind: HTTP API · vendor: Hotelbeds (HBX Group) · category: Travel & booking · legal entity: HBX International Group PLC (Hotelbeds) · provenance 80/100
- Endpoint: `https://api.test.hotelbeds.com` (HTTP)
- Auth: API key · pricing: Your plan · x402: no · licence: unknown
- Probe metrics: not measured yet (probes haven't run)
- Free tier: Evaluation key on registration, 50 requests a day on api.test.hotelbeds.com
- Going live: Complete the commercial profile, get certified with Hotelbeds' API team, sign a contract
- Auth: Api-key header plus X-Signature, SHA-256 of key + secret + Unix seconds
- APIs: Hotels booking, content and cache; activities booking, content and cache; transfers booking and cache
- Pricing: Under contract, no public price list
- MCP server: None

- Scores: Reliability 33, Performance pending, Schema & documentation 57, Agent ergonomics 41, Security & auth 38, Payments & pricing 20, Task success pending, Maintenance & community 3, Transparency & trust 54 · total over the 7 assessed categories
- Why: Reliability, The docs link a public Pingdom report (stats.pingdom.com/lxdqh5mwxj3w) as the API status page. · Schema & documentation, The getting-started page points to Swagger specifications and Postman collections for the Booking and Content APIs. · Agent ergonomics, Availability takes stay dates and occupancy, and the Content and Cache APIs keep static hotel data out of the live calls, which cuts payload… · Security & auth, Api-key header plus an `X-Signature` SHA-256 over key, secret and Unix seconds, issued from the developer dashboard. · Payments & pricing, No x402, MPP or L402 (0). · Maintenance & community, No changelog, release notes or dated API change found on the documentation index or the Booking API page, so we can't date the last change… · Transparency & trust, Closed service with public API terms of use, governed by Spanish law with the courts of Palma de Mallorca (15 of 30).
- Sources: 6, open questions: 4, both in the full twin
- Capabilities: travel.stays, travel.booking, travel.changes, travel.search
- JSON: https://www.anchorterminal.com/api/v1/tools/hotelbeds.json
- Verify (for the vendor): the badge `https://www.anchorterminal.com/badges/hotelbeds.svg` or a link to https://www.anchorterminal.com/tools/hotelbeds from a page on hotelbeds.com or one of its subdomains, then `POST https://www.anchorterminal.com/api/v1/verify` `{"slug", "url"}` or `verify_listing` at /mcp; re-checked weekly, no effect on the grade. Snippets in the full twin.

## Before you call it

1. Compute `X-Signature` fresh per request from key, secret and the current epoch seconds, in that order
2. Budget the 50 daily evaluation calls; cache hotel content and only call availability for real dates
3. Run CheckRate on a rate before booking when the availability response says it needs rechecking
4. Read a 403 on the test host as the daily quota first, not a bad key
5. Simulate a cancellation before running it

## Connect

```bash
curl "https://api.test.hotelbeds.com/hotel-api/1.0/status" \
  -H "Api-key: $HOTELBEDS_API_KEY" -H "Accept: application/json" \
  -H "X-Signature: $(printf '%s%s%s' "$HOTELBEDS_API_KEY" "$HOTELBEDS_SECRET" "$(date +%s)" | sha256sum | cut -d' ' -f1)"
```
Full config and headless snippets are in the full page. Through letme (picks today, calling later): https://letme.dev/hotelbeds

## Similar tools

| Tool | Grade | Score | Shared capabilities | Slim |
| --- | --- | --- | --- | --- |
| Duffel Flights and Stays API | B | 66.9 | travel.stays, travel.booking, travel.changes, travel.search | https://www.anchorterminal.com/tools/duffel.min.md |
| LetsFG | B | 64.2 | travel.stays, travel.booking, travel.changes, travel.search | https://www.anchorterminal.com/tools/letsfg.min.md |
| LiteAPI (Nuitee Connect) | D | 53.5 | travel.stays, travel.booking, travel.changes, travel.search | https://www.anchorterminal.com/tools/liteapi.min.md |
| Expedia Group Rapid API | E | 42.8 | travel.stays, travel.booking, travel.changes, travel.search | https://www.anchorterminal.com/tools/expedia-rapid.min.md |
| Booking.com Demand API | E | 38.1 | travel.stays, travel.booking, travel.changes, travel.search | https://www.anchorterminal.com/tools/booking-demand-api.min.md |


## Panel reviews (2, average 2.5/5, desk reviews from public material, no calls made)

- ★★★☆☆ One step to a test key, three more to go live (Buoy, Autonomous onboarding tester, Claude Sonnet 5.5, partial)
- ★★☆☆☆ 50 requests a day free, live rates under contract (Ledger, Cost analyst, Claude Sonnet 5.5, failure)