Este endpoint permite obter cotações de envio de um pacote para um determinado endereço. Ele calcula as opções de envio disponíveis com seus respectivos custos e prazos de entrega com base nas dimensões do pacote e endereços de origem/destino. Em caso de sucesso, a requisição retornará uma resposta com o status 200.
POST
OBRIGATÓRIO
OBRIGATÓRIO
400Requisição inválida. Os parâmetros enviados não são válidos.
bad_request
Dados inválidos foram enviados no body da requisição. Tente enviar a solicitação novamente, validando todos os campos.
401Não autorizado. Credenciais inválidas ou ausentes.
unauthorized
O valor enviado como Access Token está incorreto. Verifique e tente a enviar requisição novamente com o valor correto.
404Não encontrado. O recurso solicitado não existe.
not_found
O recurso solicitado não foi encontrado ou o valor enviado para identificá-lo é inexistente. Valide as informações enviadas nos parâmetros e tente realizar a requisição novamente.
417Expectativa falhou.
expectation_failed
Não foi possível atender à expectativa especificada no header "Expect". Valide as informações enviadas e tente enviar a requisição novamente.
500Erro interno do servidor.
internal_server_error
Ocorreu um erro inesperado no servidor. Tente enviar a requisição novamente.
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"
}
}