Cómo buscar autos de alquiler disponibles
El punto final de Search Rentals devuelve una lista paginada de vehículos disponibles para una ubicación y un rango de fechas determinados. Esta es la llamada de búsqueda principal que impulsa la página de resultados de su vehículo de alquiler.
Punto final
GET /cars/api/v2/rentals
Parámetros de solicitud
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
country | cadena | Sí | Código de país ISO de dos letras (por ejemplo, US, GB). |
pickupdate | cadena | Sí | Fecha y hora de recogida en formato ISO 8601 (p. ej., 2026-06-15T10:00:00). |
returndate | cadena | Sí | Fecha y hora de devolución en formato ISO 8601 (por ejemplo, 2026-06-20T10:00:00). |
pickuptype | cadena | Sí | Tipo de ubicación para la recogida. Utilice "geo" para búsqueda basada en coordenadas. |
returntype | cadena | Sí | Tipo de ubicación para la devolución. Utilice "geo" para búsqueda basada en coordenadas. |
pickupcode | cadena | Sí | Coordenadas de recogida como "lat,lon" (desde el punto final de autocompletar). |
returncode | cadena | Sí | Devuelve las coordenadas como "lat,lon" (desde el punto final de autocompletar). |
currency | cadena | Sí | Código de moneda de tres letras (por ejemplo, USD, EUR, GBP). |
pickupgeo | cadena | No | Contexto geográfico adicional para el lugar de recogida. |
driverage | número | No | Edad del conductor principal. Afecta la disponibilidad y los precios para conductores jóvenes y mayores. |
sort | cadena | No | Orden de clasificación: "distance" (el más cercano primero) o "price" (el más bajo primero). |
page | número | No | Número de página para paginación (comienza en 1). |
limit | número | No | Número de resultados por página. |
filter | cadena | No | Filtrar expresión. Consulte Cómo utilizar los filtros de búsqueda de alquiler de vehículos. |
language | cadena | No | Código de idioma para contenido localizado (por ejemplo, en, es). |
Formato de fecha
Las fechas deben incluir un componente de hora en formato ISO 8601. La hora determina la hora de recogida y devolución en el lugar de alquiler.
2026-06-15T10:00:00 ← Pickup at 10:00 AM on June 15
2026-06-20T14:30:00 ← Return at 2:30 PM on June 20
La duración y el precio del alquiler se calculan en función de la fecha y la hora. Un alquiler de 5 días devuelto con una hora de retraso puede generar un cargo por día adicional, según las reglas de tarifas del proveedor.
Solicitud de ejemplo
HTTP
GET /cars/api/v2/rentals?country=US&pickupdate=2026-06-15T10:00:00&returndate=2026-06-20T10:00:00&pickuptype=geo&returntype=geo&pickupcode=40.7128,-74.006&returncode=40.7128,-74.006¤cy=USD&sort=price&page=1&limit=20
x-api-key: YOURAPIKEY
x-correlation-id: 550e8400-e29b-41d4-a716-446655440000
Authorization: Bearer YOUR_SIGNATURE
Ejemplo de respuesta
JSON
{
"data": {
"pickupdate_time": "2026-06-15T10:00:00",
"returndatetime": "2026-06-20T10:00:00",
"avails": [
{
"id": "avl_abc123",
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6...",
"status": "available",
"rentalcarbrand": "Hertz",
"vehicle": {
"air_conditioning": true,
"transmission_type": "Automatic",
"fuel_type": "Petrol",
"drive_type": "2WD",
"passenger_quantity": 5,
"baggage_quantity": 2,
"vehicle_size": "Standard",
"vehicle_type": "Sedan",
"sipp_code": "CCAR",
"name": "Toyota Camry or similar",
"door_count": 4,
"picture_url": "https://images.example.com/camry.png"
},
"rental_rate": {
"rate_distance": "Unlimited",
"vehicle_charges": [
{
"currency_code": "USD",
"base_price": 245,
"total_price": 289.75,
"tax_inclusive": true,
"purpose": "rental"
}
],
"rate_restrictions": {
"minimum_age": 21,
"maximum_age": 75
}
},
"fees": [],
"pickup_location": {
"name": "Hertz - Manhattan Midtown",
"coordinates": {
"lat": 40.7549,
"lon": -73.984
}
},
"dropoff_location": {
"name": "Hertz - Manhattan Midtown",
"coordinates": {
"lat": 40.7549,
"lon": -73.984
}
},
"distance": 4.8,
"coverages": [],
"payment_rules": []
}
]
}
}Campos de respuesta clave
| Campo | Descripción |
|---|---|
token | Token de disponibilidad. Pase esto a los puntos finales de Detalles y Reservas. |
rentalcarbrand | Nombre de la empresa de alquiler (p. ej., Hertz, Enterprise). |
vehicle | Objeto que contiene las especificaciones del automóvil (tipo, tamaño, código SIPP, capacidad, etc.). |
rentalrate | Desglose de precios que incluye el precio base, el precio total y cualquier restricción de edad. |
distance | Distancia en kilómetros desde las coordenadas de búsqueda hasta el lugar de recogida. |
pickuplocation | Nombre y coordenadas de la sucursal de retiro. |
dropoff_location | Nombre y coordenadas de la sucursal de entrega. |
PaginaciónUtilice los parámetros page y limit para paginar los resultados:
page=1&limit=20 ← First 20 results
page=2&limit=20 ← Results 21-40
Alquileres de ida
Para buscar un alquiler de ida (lugar de entrega diferente), pase coordenadas diferentes para pickupcode y returncode:
pickupcode=40.7128,-74.006&returncode=42.3601,-71.0589
Los alquileres de ida pueden tener cargos adicionales que aparecen en la matriz fees de la respuesta.
Consejos
- Incluye siempre una hora en
pickupdateyreturndate. Omitir el componente de tiempo dará como resultado un error. - Utilice el parámetro
sortpara presentar los resultados en el orden más útil para sus usuarios."price"es mejor para viajeros centrados en su presupuesto;"distance"es mejor cuando es importante la proximidad al lugar de recogida. - Almacena el
tokenpara cada resultado. Lo necesitará cuando llame al punto final de Detalles o cuando cree una reserva.