HotelRates
Endpoint
Sección titulada «Endpoint»POST {base_url}/1.0/hotels/ratesDevuelve disponibilidad y tarifas de uno o más hoteles en un rango de fechas.
Headers
Sección titulada «Headers»| Header | Valor |
|---|---|
Authorization |
Bearer <access_token> |
Content-Type |
application/json |
Accept |
application/json |
Accept-Encoding |
gzip |
Query params
Sección titulada «Query params»| Parámetro | Requerido | Tipo | Notas |
|---|---|---|---|
language |
No | string | Idioma del contenido de la respuesta. Valores aceptados: en-us, es-mx. Default: en-us |
Tu channel tiene un idioma por defecto (inglés, salvo que se configure otro); para pedir uno distinto, usa ?language= — ver Idiomas.
Cuerpo de la petición
Sección titulada «Cuerpo de la petición»{ "checkIn": "2027-05-15", "checkOut": "2027-05-16", "roomCriteria": [ { "paxes": [ { "age": 30 } ] } ], "hotelIds": [100652], "hotelRateFilter": { "nonRefundable": false }, "market": "MX"}Campos del body
Sección titulada «Campos del body»| Campo | Requerido | Tipo | Notas |
|---|---|---|---|
checkIn |
Yes | string (YYYY-MM-DD) | No puede ser una fecha pasada |
checkOut |
Yes | string (YYYY-MM-DD) | Debe ser > checkIn |
roomCriteria[] |
Yes | array | Una entrada por cada habitación solicitada |
roomCriteria[].paxes[] |
Yes | array | Lista de pax — se requiere al menos un adulto (18+) |
roomCriteria[].paxes[].age |
Yes | int | Menor de 17 = menor |
hotelIds[] |
Yes | array of int | Máximo 50 IDs por llamada |
hotelRateFilter.nonRefundable |
No | bool | Filtro de tarifas. En una muestra de Integration, true y false devolvieron las mismas 19 tarifas — 7 no reembolsables y 12 reembolsables en las dos — así que no dependas de él para reducir resultados, y comprueba cancellationPolicies en cada tarifa. Default: false |
market |
No | string | Código de país ISO del catálogo de Market (p. ej. MX, IN, US, ES) |
Si envías name y surname en roomCriteria[].paxes[], no esperes que BookingGet los devuelva — ver BookingGet. Para enviar los nombres de los huéspedes por habitación, usa BookingHold: ver Guest data in the hold.
Respuesta (éxito)
Sección titulada «Respuesta (éxito)»{ "hotels": [ { "id": 100652, "name": "Ocean View Cancun Arenas", "rooms": [ { "id": 16370816, "name": "Standard", "rates": [ { "rateKey": "RMDsX5...AAB=", "clientCurrency": "USD", "cancellationPolicies": [ { "startDate": "2027-05-12T00:00:00Z", "endDate": "2027-05-15T23:59:59Z", "amount": 116.00, "currency": "USD" } ], "reservationPolicies": [ { "type": "MEAL_PLAN", "code": "I", "description": "All Inclusive" }, { "type": "RESERVATION", "code": "PREPAID", "description": "Prepaid" } ], "amount": 116.00, "publicAmount": 135.98, "taxes": { "total": 16.00, "details": [] }, "feesNotIncluded": { "total": 0, "details": [], "currency": "" } } ] } ] } ], "eventId": "93072334-e0f6-4abd-9c9c-02ffca872382"}Campos de la respuesta
Sección titulada «Campos de la respuesta»| Campo | Tipo | Descripción |
|---|---|---|
hotels[].id |
int | Identificador del hotel |
hotels[].name |
string | Nombre del hotel |
hotels[].rooms[].id |
int | ID del tipo de habitación |
hotels[].rooms[].name |
string | Nombre de la habitación |
hotels[].rooms[].rates[].rateKey |
string | Úsalo para CheckRates — válido 60 min |
hotels[].rooms[].rates[].clientCurrency |
string | Moneda de los precios mostrados |
hotels[].rooms[].rates[].amount |
decimal | Monto neto que paga la agencia |
hotels[].rooms[].rates[].publicAmount |
decimal | Precio de venta recomendado (incluye margen) |
hotels[].rooms[].rates[].cancellationPolicies |
array | Penalización por rango de fechas (UTC) |
hotels[].rooms[].rates[].reservationPolicies |
array | Plan de alimentos + tipo de reserva |
hotels[].rooms[].rates[].taxes |
object | Obligatorios + otros (informativo) |
hotels[].rooms[].rates[].feesNotIncluded |
object | Cargos cobrados en el check-in del hotel |
eventId |
string | ID de traza — inclúyelo al reportar incidencias |
Cómo identificar tarifas no reembolsables
Sección titulada «Cómo identificar tarifas no reembolsables»Una tarifa es efectivamente no reembolsable cuando:
cancellationPolicies[i].amount === rates.amountLa penalización iguala el precio de la tarifa → penalización del 100% → no hay ventana real de reembolso.
Errores específicos de este endpoint
Sección titulada «Errores específicos de este endpoint»| Código | HTTP | Mensaje | Causa | Qué hacer |
|---|---|---|---|---|
| 429 | 429 | Request rate limit exceeded | Demasiadas peticiones en poco tiempo | Reduce el ritmo de peticiones y reintenta con espera |
| 1002 | 401 | agency configuration not Found | Channel/agencia no provisionada | Contacta a PriceTravel con el request, el response y el eventId |
| 1003 | 400 | Invalid agency templateId | Problema de configuración de la agencia en PT | Contacta a PriceTravel con el request, el response y el eventId |
| 3001 | 400 | CheckIn can not be a past date | checkIn es anterior a hoy |
Envía un checkIn de hoy o posterior |
| 3002 | 400 | CheckOut can not be earlier or equal to CheckIn | checkOut es igual o anterior a checkIn |
Envía un checkOut posterior al checkIn |
| 3003 | 400 | Can’t quote more than 28 days | El rango solicitado supera los 28 días | Divide la estancia en peticiones de 28 días o menos |
| 3004 | 400 | All rooms must contain at least one adult (18+) | Una habitación de roomCriteria no tiene ningún pax de 18 años o más |
Incluye al menos un pax de 18 años o más en cada habitación |
| 4001 | 500 | Invalid Channel Id on Rate Limiter | Interno | Contacta a PriceTravel con el request, el response y el eventId |
| 5001 | 500 | Miss-match of channel Id | Discrepancia de channel | Contacta a PriceTravel con el request, el response y el eventId |
Patrones de diagnóstico
Sección titulada «Patrones de diagnóstico»| Síntoma | Causa probable |
|---|---|
hotels[] vacío pero sin error |
No hay disponibilidad para esas fechas/criterios |
| El mismo hotel devuelve tarifas un minuto y al siguiente no | Fluctuación de inventario en tiempo real del proveedor |
| 429 en cada reintento | Rate limit del channel — espera y reintenta con retardo |
Fees currency: "" |
El hotel no cobra cargos a la llegada |

