Este endpoint permite obtener cotizaciones de envío de un paquete para una dirección determinada. Calcula las opciones de envío disponibles con sus respectivos costos y tiempos de entrega basándose en las dimensiones del paquete y direcciones de origen/destino. En caso de éxito, la solicitud devolverá una respuesta con el estado 200.
POST
REQUERIDO
REQUERIDO
400Solicitud inválida. Los parámetros enviados no son válidos.
bad_request
Se enviaron datos inválidos en el body de la solicitud. Vuelve a intentar enviar la solicitud, validando todos los campos.
401No autorizado. Credenciales inválidas o faltantes.
unauthorized
El valor enviado como Access Token es incorrecto. Por favor, verifícalo y vuelve a realizar la solicitud enviando el valor correcto.
404No encontrado. El recurso solicitado no existe.
not_found
El recurso solicitado no fue encontrado o el valor enviado para identificarlo es inexistente. Valida la información enviada en los parámetros y vuelve a intentarlo.
417Expectativa fallida.
expectation_failed
No se pudo cumplir con la expectativa especificada en el header "Expect". Valida la información enviada y vuelve a intentarlo.
500Error interno del servidor.
internal_server_error
Ocurrió un error inesperado en el servidor. Vuelve a intentar la solicitud.
curl -X POST \
'https://api.mercadopago.com/shipping/v1/shipments-rates'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-4*********994754-12*********c73b4e1ac*********cef36b27c*********840' \
-d '{
"packages": [
{
"declared_value": 1500,
"quantity": 1,
"dimensions": {
"weight": 500,
"width": 30,
"height": 30,
"length": 30
}
}
],
"shipping_from": {
"zip_code": "06760"
},
"shipping_to": {
"zip_code": "06760"
}
}'{
"shipment_rate_id": "be9fae0d-1079-471e-887d-55861965d10e",
"rates": [
{
"options": [
{
"id": "3c86ea36-fef7-4a9e-9092-d4eb6e744834",
"pricing": {
"base_price": "87",
"price": "87",
"discounts": [
{}
]
},
"pay_before": "2025-10-27T00:00:00-06:00",
"delivery_promise": {
"shipping_from": "2025-10-28T12:00:00-06:00",
"shipping_to": "2025-10-30T12:00:00-06:00"
},
"delivery_days": {
"from": 3,
"to": 5
}
}
],
"packages": [
{
"quantity": 1,
"dimensions": {
"weight": 500,
"width": 30,
"height": 30,
"length": 30
}
}
]
}
],
"shipping_to": {
"zip_code": "06760",
"country_id": "MX",
"city_id": "TUxNQ0NVQTczMTI",
"state_id": "MX-DIF"
}
}