{"openapi":"3.1.0","info":{"title":"ALD Mobility · API pública","version":"1.0.0","description":"Consulta de puntos de recogida, condiciones, flota y presupuestos del alquiler de coches por días de ALD Mobility (Madrid y Costa del Sol). Solo lectura, sin datos personales y sin claves. La disponibilidad no es en tiempo real: los vehículos están disponibles para solicitar y el equipo confirma cada reserva. La reserva no se hace por la API: el presupuesto devuelve un enlace a la web, donde el cliente la revisa, acepta las condiciones y la envía. También disponible como servidor MCP en https://aldmobility.es/mcp. Precios en euros con IVA incluido.","contact":{"name":"ALD Mobility","email":"cliente@aldmobility.es","url":"https://aldmobility.es/desarrolladores"}},"servers":[{"url":"https://aldmobility.es/api/v1"}],"externalDocs":{"description":"Documentación y condiciones de uso","url":"https://aldmobility.es/desarrolladores"},"paths":{"/puntos":{"get":{"operationId":"listarPuntos","summary":"Puntos de recogida con su horario, zona, suplemento y entrega en hotel.","responses":{"200":{"description":"Lista de puntos."},"400":{"description":"Consulta no válida (parámetros que faltan, sobran o con formato incorrecto)."},"429":{"description":"Demasiadas consultas seguidas desde la misma IP (ráfagas de 300, 5 por segundo sostenidas, 50.000 al día). Cabecera Retry-After con los segundos de espera."}}}},"/condiciones":{"get":{"operationId":"consultarCondiciones","summary":"Condiciones del alquiler: fianza, seguro, kilometraje, combustible, requisitos, antelación, días mínimos y máximos, pago, cancelación y extras.","responses":{"200":{"description":"Condiciones."},"400":{"description":"Consulta no válida (parámetros que faltan, sobran o con formato incorrecto)."},"429":{"description":"Demasiadas consultas seguidas desde la misma IP (ráfagas de 300, 5 por segundo sostenidas, 50.000 al día). Cabecera Retry-After con los segundos de espera."}}}},"/vehiculos":{"get":{"operationId":"buscarVehiculos","summary":"Flota con precio base por día (IVA incluido), del más barato al más caro, con fotos, categoría, carrocería, equipamiento y descripción.","parameters":[{"name":"punto","in":"query","required":false,"description":"Punto de recogida.","schema":{"type":"string","enum":["madrid-centro","madrid-barajas","madrid-atocha","madrid-chamartin","malaga-aeropuerto","marbella"]}},{"name":"categoria","in":"query","required":false,"description":"Categoría.","schema":{"type":"string","enum":["economico","compacto","suv","premium","deportivo","furgoneta"]}},{"name":"combustible","in":"query","required":false,"description":"Combustible.","schema":{"type":"string","enum":["gasolina","diesel","hibrido","hibrido-enchufable","electrico"]}},{"name":"cambio","in":"query","required":false,"description":"Cambio.","schema":{"type":"string","enum":["manual","automatico"]}},{"name":"plazas","in":"query","required":false,"description":"Plazas mínimas.","schema":{"type":"integer","minimum":1,"maximum":9}}],"responses":{"200":{"description":"Vehículos."},"400":{"description":"Consulta no válida (parámetros que faltan, sobran o con formato incorrecto)."},"429":{"description":"Demasiadas consultas seguidas desde la misma IP (ráfagas de 300, 5 por segundo sostenidas, 50.000 al día). Cabecera Retry-After con los segundos de espera."}}}},"/presupuesto":{"get":{"operationId":"calcularPresupuesto","summary":"Precio exacto de un alquiler (mismo cálculo que la web) y enlace a la reserva ya rellena. Fechas y horas en hora de Madrid.","parameters":[{"name":"vehiculo","in":"query","required":true,"description":"Id del vehículo (de /vehiculos).","schema":{"type":"string","examples":["renault-clio"]}},{"name":"punto","in":"query","required":true,"description":"Punto de recogida.","schema":{"type":"string","enum":["madrid-centro","madrid-barajas","madrid-atocha","madrid-chamartin","malaga-aeropuerto","marbella"]}},{"name":"punto_devolucion","in":"query","required":false,"description":"Punto de devolución (por defecto, el de recogida).","schema":{"type":"string","enum":["madrid-centro","madrid-barajas","madrid-atocha","madrid-chamartin","malaga-aeropuerto","marbella"]}},{"name":"fecha_recogida","in":"query","required":true,"description":"Fecha de recogida.","schema":{"type":"string","format":"date","examples":["2026-12-10"]}},{"name":"hora_recogida","in":"query","required":true,"description":"Hora de recogida.","schema":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$","examples":["10:00"]}},{"name":"fecha_devolucion","in":"query","required":true,"description":"Fecha de devolución.","schema":{"type":"string","format":"date","examples":["2026-12-10"]}},{"name":"hora_devolucion","in":"query","required":true,"description":"Hora de devolución.","schema":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$","examples":["10:00"]}},{"name":"edad","in":"query","required":false,"description":"Franja de edad del conductor (por defecto, 30+).","schema":{"type":"string","enum":["21-24","25-29","30+"]}},{"name":"extras","in":"query","required":false,"description":"Extras opcionales (ids de /condiciones) con formato id:cantidad separados por comas. La entrega en hotel solo en los puntos que la admiten.","schema":{"type":"string","examples":["silla-infantil:2,gps:1"]}}],"responses":{"200":{"description":"Presupuesto con desglose, total con IVA y bookingUrl."},"400":{"description":"Consulta no válida (parámetros que faltan, sobran o con formato incorrecto)."},"404":{"description":"No existe un vehículo con ese id."},"422":{"description":"El vehículo no está en ese punto, no admite esa edad, un extra no existe o supera su cantidad máxima, o las fechas no cumplen las condiciones (24 horas de antelación, máximo 60 días, horario del punto)."},"429":{"description":"Demasiadas consultas seguidas desde la misma IP (ráfagas de 300, 5 por segundo sostenidas, 50.000 al día). Cabecera Retry-After con los segundos de espera."}}}}}}