API v2

The hotel API, family by family.

Base URL https://api.vistalink.com, every route under /v2. Sync endpoints answer straight away; jobs answer 202 and finish in the background.

Start with the family that matches the job. Each page has every field, a request in four forms and the price.

Families
IdentifiersTurn Booking.com and Expedia URLs, hotel websites or a name and city into hotel ids. Free.SyncFreeSearchFilters or free text in, ranked hotel cards out, with cached prices when you send dates.Sync$0.003–$0.012 / searchHotelsThe full profile: gallery, rooms and their listings, venues, policies, reviews and prices for a stay.Sync$0.005 / callRatesPrices from each hotel's own booking engine, from cache now or read live as a job.Sync + job$0.002–$0.040 / hotelRoomsMatch one hotel's rooms across Booking.com, its own site, Expedia and your own list, with a confidence each.Sync + job$0.08–$0.25 / reconciliationBookingsBook an offer on the hotel's own engine. The guest pays the property; booking is free.Sync + jobFree
Everything else
  • Quick start: Get a key, make one search, read the response.
  • Authentication: Bearer keys, live and test, and the scopes each endpoint needs.
  • Jobs & webhooks: Poll or cancel background work, and register endpoints that hear when it finishes.
  • MCP: The core v2 calls as MCP tools, billed under the same SKUs.
  • Errors & limits: The error envelope, every error code, rate limits per tier and how to retry.
  • Billing: Every SKU and its price, the four tiers, and how credit is spent.
  • Changelog: Dated changes to the v2 API and the v1 sunset plan.
All endpoints
POST/v2/hotels/resolve
Resolve hotel identifiers to hotel_idSync · Free
POST/v2/search
Search hotelsSync · $0.003–$0.012 / search
GET/v2/hotels/{hotel_id}
Hotel detailSync · $0.005 / call
POST/v2/rates
Rates for a staySync / job · $0.002–$0.040 / hotel
POST/v2/rates/batch
Rates for many hotels and staysJob · $0.002–$0.040 / hotel
POST/v2/rooms/reconcile
Reconcile room types across sourcesJob / sync · $0.08–$0.25 / reconciliation
POST/v2/bookings
Create a bookingJob · Free
GET/v2/bookings/{booking_id}
Get a bookingSync · Free
POST/v2/bookings/{booking_id}/cancel
Cancel a bookingSync · Free
GET/v2/jobs/{job_id}
Get a jobSync · Free
GET/v2/jobs/{job_id}/result
Download a job's resultSync · Free
GET/v2/jobs
List jobsSync · Free
POST/v2/jobs/{job_id}/cancel
Cancel a jobSync · Free
GET/v2/webhooks
List webhooksSync · Free
POST/v2/webhooks
Create a webhookSync · Free
DELETE/v2/webhooks/{webhook_id}
Delete a webhookSync · Free
GET/v2/webhooks/{webhook_id}/deliveries
List deliveriesSync · Free
POST/v2/chat
Conversational hotel searchSync · $0.03 / turn
GET/v2/amenities
Amenity codesSync · Free
GET/v2/engines
Supported booking enginesSync · Free
GET/v2/health
HealthSync · Free
GET/v2/openapi.json
This OpenAPI documentSync · Free