Quotes & Rates
Get Shipping Rates
Retrieve real-time shipping rates from multiple carriers in a single request so you can compare pricing and delivery estimates.
When to use: Call this endpoint to compare carrier rates and transit times before generating a label. Use the response to let your users pick the best option.
Prerequisites:
- Valid JWT authentication token (Bearer)
- Origin and destination addresses with country-specific fields (use the Queries API to look up postal codes, cities, and neighborhoods)
- At least one package with dimensions (length, width, height in cm) and weight (in kg)
Key behaviors:
- Returns an array of rate objects, one per carrier/service combination
- Each rate includes estimated price, currency, transit days, and service level
- Supports domestic and international shipments across all available carriers
- Address field requirements vary by country; consult the Queries API endpoints to obtain valid values
- Colombia only: the city field must contain the 8-digit DANE municipal code, not a human-readable city name. Use POST /locate to resolve it from the city name before calling this endpoint
- You can optionally filter by carrier using the carrier field in the shipment object
post/ship/rate/
Request body
Example request
{
"origin": {
"name": "Juan Pérez",
"company": "Envia Corp",
"email": "juan.perez@example.com",
"phone_code": "+52",
"phone": "8180000000",
"street": "Av. Revolución 500",
"number": "500",
"district": "Centro",
"city": "Monterrey",
"state": "NL",
"country": "MX",
"postalCode": "64060",
"reference": "Frente al parque",
"address_id": 12345,
"identificationNumber": "XAXX010101000",
"coordinates": {
"latitude": "25.6866",
"longitude": "-100.3161"
}
},
"destination": {
"name": "María García",
"company": "Tienda Online SA",
"email": "maria.garcia@example.com",
"phone_code": "+52",
"phone": "5512345678",
"street": "Insurgentes Sur",
"number": "3000",
"district": "Coyoacán",
"city": "Ciudad de México",
"state": "CX",
"country": "MX",
"postalCode": "04530",
"reference": "Edificio azul, piso 3",
"address_id": 12345,
"identificationNumber": "XAXX010101000",
"coordinates": {
"latitude": "19.4326",
"longitude": "-99.1332"
}
},
"packages": [
{
"type": "box",
"content": "Electronics",
"amount": 1,
"name": "Standard Box",
"declaredValue": 500,
"lengthUnit": "CM",
"weightUnit": "KG",
"weight": 2.5,
"dimensions": {
"length": 30,
"width": 20,
"height": 15
},
"additionalServices": [
{
"data": {
"amount": "500"
},
"service": "envia_insurance"
}
],
"items": [
{
"description": "Wireless headphones",
"productCode": "8518.30",
"quantity": 2,
"countryOfManufacture": "CN",
"price": 45,
"currency": "MXN"
}
],
"bolComplement": [
{
"productCode": "8518.30",
"productDescription": "Electronic components",
"weightUnit": "KG",
"quantity": 2,
"unitPrice": 25,
"currency": "MXN"
}
]
}
],
"settings": {
"currency": "MXN",
"comments": "Fragile items, handle with care"
},
"shipment": {
"type": 1,
"carrier": "ups",
"service": "express",
"declaredValue": 500,
"additionalServices": [
{
"service": "envia_insurance"
}
],
"pickup": {
"date": "2026-03-10",
"totalPackages": 5,
"totalWeight": 12.5
}
},
"customsSettings": {
"dutiesPaymentEntity": "receiver",
"exportReason": "sale"
}
}Response
Shipping rates response
Example response
{
"meta": "rate",
"data": [
{
"carrierId": 2,
"carrier": "dhl",
"carrierDescription": "DHL",
"serviceId": 6,
"service": "ground",
"serviceDescription": "DHL Economy ",
"dropOffDescription": "Door - Door",
"zone": 3,
"deliveryEstimate": "2-4 días",
"deliveryDate": {
"date": "2026-02-24",
"dateDifference": 1,
"timeUnit": "day",
"time": "23:59"
},
"quantity": 1,
"basePrice": 238.42,
"basePriceTaxes": 38.15,
"additionalCharges": 81.34,
"additionalChargesTaxes": 13.01,
"taxes": 51.16,
"totalPrice": 370.92,
"currency": "MXN",
"costSummary": [
{
"quantity": 1,
"basePrice": 238.42,
"basePriceTaxes": 38.15,
"additionalCharges": 81.34,
"additionalChargesTaxes": 13.01,
"taxes": 51.16,
"totalPrice": 370.92,
"costAdditionalCharges": [
{
"id": 71,
"addToInvoice": 1,
"conceptId": 24,
"additionalService": "fuel",
"translationTag": "createLabel.shippingInfo.fuelSurcharge",
"amount": 1,
"commission": 31.34,
"taxes": 5.01,
"cost": 36.35
}
],
"currency": "MXN",
"securityWeight": "2.5"
}
],
"packageDetails": {
"totalWeight": 2.5,
"weightUnit": "KG",
"details": [
{
"appliedWeightType": "declared",
"weightUnit": "KG",
"weight": 2.5,
"content": "T-shirts"
}
]
}
}
]
}