Precio de un traslado

post/api/v1/presupuestocon clave

Devuelve el importe con IVA incluido, la distancia, el tiempo y el desglose. Es el mismo cálculo que usa la web y el que se cobra al reservar. En partner va además el precio para la clave que llama, según su modo (público, neto o con descuento). Con stops el recorrido se parte en tramos y el precio sale del encadenado, nunca por debajo del directo; stops.accepted: false significa que el importe es el del directo y que el alta las va a rechazar.

Parámetros

Nombre	En	Tipo	Descripción
X-Market-Id	header	string	El mercado en el que se presupuesta o reserva (`GLO-12`): uno de los `id` de `GET /api/mercados`. Sin cabecera, el mercado lo decide el dominio por el que se entra, y en los de Castilla-La Mancha es el de casa. Los importes vuelven en la moneda del mercado. Una clave acotada a unos mercados recibe 403 fuera de ellos.

Cuerpo `PresupuestoPeticion`

Campo	Tipo	Descripción
origin *	string
destination *	string
pickupAt *	string	Fecha y hora local, formato YYYY-MM-DDTHH:mm
returnAt	string	Vuelta, si se contrata a la vez. Se presupuesta como segundo trayecto.
passengers	integer
hours	number	Horas contratadas. Con horas el precio sale de la tarifa por hora y el recorrido no se cobra además: es el vehículo a disposición.
categorySlug	string	Categoría de vehículo
originLat	number	Coordenadas del punto de recogida. Sin ellas se resuelve el texto contra el catálogo de lugares, que basta para un municipio y no para un portal concreto.
originLng	number
originMunicipality	string	El municipio del punto elegido, no el texto escrito. De él dependen la regla de ámbito urbano y la ordenanza que aplique: «Calle Mayor 3» no es un municipio.
originProvince	string
originRegion	string
destinationLat	number
destinationLng	number
destinationMunicipality	string
destinationProvince	string
destinationRegion	string
stops	Parada[]	Paradas intermedias, en el orden en que se hacen. Cinco como mucho: un trayecto con quince paradas no es un traslado, es un servicio por horas, y se contrata así (`hours`).

* obligatorio

Respuestas

200Presupuesto
401Clave no válida
422Punto no reconocido o fuera de ámbito
429Límite de peticiones superado

Qué hacer con cada error: errores, límites y reintentos.

Ejemplos

La clave va en la variable de entorno RIDELTA_API_KEY, nunca escrita en el código.

cURL

curl -X POST "https://ridelta.com/api/v1/presupuesto" \
  -H "Authorization: Bearer $RIDELTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"origin":"Illescas","destination":"Aeropuerto Madrid-Barajas","pickupAt":"2026-10-04T05:30"}'

JavaScript (fetch)

const respuesta = await fetch("https://ridelta.com/api/v1/presupuesto", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.RIDELTA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "origin": "Illescas",
    "destination": "Aeropuerto Madrid-Barajas",
    "pickupAt": "2026-10-04T05:30"
  }),
});
if (!respuesta.ok) throw new Error(`${respuesta.status}: ${await respuesta.text()}`);
const datos = await respuesta.json();

Python (requests)

import os
import requests

respuesta = requests.request(
    "POST",
    "https://ridelta.com/api/v1/presupuesto",
    headers={"Authorization": f"Bearer {os.environ['RIDELTA_API_KEY']}"},
    json={"origin":"Illescas","destination":"Aeropuerto Madrid-Barajas","pickupAt":"2026-10-04T05:30"},
    timeout=15,
)
respuesta.raise_for_status()
datos = respuesta.json()

PHP (cURL)

<?php
$ch = curl_init('https://ridelta.com/api/v1/presupuesto');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 15,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('RIDELTA_API_KEY'), 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => json_encode(['origin' => 'Illescas', 'destination' => 'Aeropuerto Madrid-Barajas', 'pickupAt' => '2026-10-04T05:30']),
]);
$datos = json_decode(curl_exec($ch), true);
$estado = curl_getinfo($ch, CURLINFO_HTTP_CODE);

Precio de un traslado

Parámetros

Cuerpo PresupuestoPeticion

Respuestas

Ejemplos

Cuerpo `PresupuestoPeticion`