---
title: "POST /api/v3/shipping/rates"
method: POST
path: "/api/v3/shipping/rates"
tags: ["shipping-rates"]
---

# POST /api/v3/shipping/rates

`POST /api/v3/shipping/rates`

Estimate shipping cost and validate coverage based on origin and destination, package dimensions, and weight. If the country is different from Mexico, the zipcode must be empty, and validation will be done using coordinates only.

## Request body

- object
  - `withTaxes` boolean, required — Indicates whether taxes should be included in the response.
  - `validateOnlyCoordinates` boolean, required — Must be true if country is not Mexico, as zipcode validation is not supported outside Mexico.
  - `origin` object, required
    - `codePostal` string — Zip code of the shipping origin. Must be empty if country is not Mexico.
    - `country` string, required — Country code (e.g., 'MEX' for Mexico).
  - `destination` object, required
    - `codePostal` string — Zip code of the shipping destination. Must be empty if country is not Mexico.
    - `country` string, required — Country code (e.g., 'MEX' for Mexico).
  - `items` object[], required
    - `weight` integer, required — Weight of the item in grams.
    - `depth` integer, required — Depth of the item in centimeters.
    - `width` integer, required — Width of the item in centimeters.
    - `height` integer, required — Height of the item in centimeters.
    - `size` string — Package size category (e.g., 's', 'm', 'l').

## Response `200`

Returns shipping cost and available service levels.

- object
  - `traceId` string
  - `message` string
  - `data` object
    - `totalCost` number — Total shipping cost including taxes if requested.
    - `serviceLevels` string[]
  - `errors` object

## Other responses

- `400` — Invalid request payload.

---

[API](https://skmtc.dev/99minutos/apis/api-version-3.md) · [All operations](https://skmtc.dev/99minutos/apis/api-version-3/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/99minutos/api-version-3/revisions/3eca3996fd97/schema)