Quote shipping options for a destination and package

curl --request GET \
  --url https://api.cubbo.com/v1/shipping-methods/quote \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.cubbo.com/v1/shipping-methods/quote', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cubbo.com/v1/shipping-methods/quote",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.cubbo.com/v1/shipping-methods/quote"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.cubbo.com/v1/shipping-methods/quote")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

[
  {
    "shipping_method_id": 12,
    "carrier_name": "ESTAFETA",
    "carrier_delivery": "Ground",
    "quoted_weight_kg": 2,
    "delivery_sla_in_hours": 72,
    "delivery_eta_range": {
      "range_begin": "2026-10-14T06:00:00.000Z",
      "range_end": "2026-10-16T05:59:59.999Z"
    },
    "price": 149
  },
  {
    "shipping_method_id": 15,
    "carrier_name": "CUBBO",
    "carrier_delivery": "NextDay",
    "quoted_weight_kg": 2,
    "delivery_sla_in_hours": null,
    "delivery_eta_range": null,
    "price": 125,
    "is_click_and_collect": true,
    "service_code": "CUBBOCNCCUBBOCUBBO001",
    "location_name": "Punto Cubbo Centro",
    "distance_km": 0.8,
    "pickup_address": "Calle Centro 300, CDMX, 06000",
    "cnc_pricing_basis": "cart_value"
  }
]

Shipping methods

Quote shipping options for a destination and package

Returns the shipping options (carrier, delivery type, estimated delivery and price) that the store’s shipping configuration would offer for a package going to the given zip code. Use it to show shipping choices at checkout. Mexico and Brazil destinations only.

To create an order with a specific shipping method, send the shipping_method_id of the option you choose as shipping_method_id in POST /orders, POST /orders/create-and-ship or POST /brazil/orders.

The shipping configuration is chosen from the store’s product shipping rules when sku matches one; otherwise the default configuration of the store’s Open API integration is used. If none can be resolved the request fails.
The quoted weight is the greater of the declared weight and the volumetric weight computed from the dimensions.
When click and collect is enabled for the store’s integration, pickup-point options are appended to the same array with is_click_and_collect: true. order_total or item_count are used to price those options, depending on how the store prices click and collect (see cnc_pricing_basis). If pickup-point pricing fails, the regular options are still returned.
delivery_eta_range is omitted when no estimate is available.

GET

shipping-methods

quote

Quote shipping options for a destination and package

curl --request GET \
  --url https://api.cubbo.com/v1/shipping-methods/quote \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.cubbo.com/v1/shipping-methods/quote', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.cubbo.com/v1/shipping-methods/quote",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.cubbo.com/v1/shipping-methods/quote"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.cubbo.com/v1/shipping-methods/quote")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

[
  {
    "shipping_method_id": 12,
    "carrier_name": "ESTAFETA",
    "carrier_delivery": "Ground",
    "quoted_weight_kg": 2,
    "delivery_sla_in_hours": 72,
    "delivery_eta_range": {
      "range_begin": "2026-10-14T06:00:00.000Z",
      "range_end": "2026-10-16T05:59:59.999Z"
    },
    "price": 149
  },
  {
    "shipping_method_id": 15,
    "carrier_name": "CUBBO",
    "carrier_delivery": "NextDay",
    "quoted_weight_kg": 2,
    "delivery_sla_in_hours": null,
    "delivery_eta_range": null,
    "price": 125,
    "is_click_and_collect": true,
    "service_code": "CUBBOCNCCUBBOCUBBO001",
    "location_name": "Punto Cubbo Centro",
    "distance_km": 0.8,
    "pickup_address": "Calle Centro 300, CDMX, 06000",
    "cnc_pricing_basis": "cart_value"
  }
]

Authorizations

Authorization

string

header

required

Token returned by POST /auth/token, sent as Authorization: Bearer <token>.

Query Parameters

store_id

integer

required

Id of the store. Your credential must have access to it.

Example:

1234

zip_code

string

required

Destination zip code

Example:

"06600"

country

enum<string>

default:MX

Destination country code. Only MX and BR are supported.

Available options:

MX,

BR

sku

string

SKU used to match the store's product shipping rules, when configured

Example:

"SKU-RED-M"

shipping_type

enum<string>

default:national

Shipment scope

Available options:

national,

international

width_cm

number

required

Package width in centimeters

Required range: x >= 0.1

Example:

20

height_cm

number

required

Package height in centimeters

Required range: x >= 0.1

Example:

10

length_cm

number

required

Package length in centimeters

Required range: x >= 0.1

Example:

30

weight_kg

number

required

Declared package weight in kilograms

Example:

1.5

order_total

number

Cart value, used to price click-and-collect options when the store prices them by cart value

Example:

1500

item_count

string

Number of units in the cart, used to price click-and-collect options when the store prices them by item count. Digits only.

Pattern: ^\d+$

Example:

"3"

Response

Shipping options. Regular options come first, click-and-collect options (if any) after them.

shipping_method_id

integer

required

Id of the shipping method to use when creating the order

Example:

12

carrier_name

string

required

Carrier name

Example:

"ESTAFETA"

carrier_delivery

enum<string>

required

Delivery service level

Available options:

SameDay,

NextDay,

Ground,

Pickup,

International

Example:

"Ground"

quoted_weight_kg

number

required

Weight the price was computed for (greater of declared and volumetric weight)

Example:

2

delivery_sla_in_hours

integer | null

required

Total delivery SLA in hours; null for click-and-collect options

Example:

72

price

number | null

required

Shipping price in the store's currency

Example:

149

delivery_eta_range

object | null

Estimated delivery window. Omitted when unavailable; null for click-and-collect options.

Show child attributes

is_click_and_collect

boolean

Present and true for pickup-point options

Example:

true

service_code

string

Pickup point identifier to send as click_and_collect_service_code when creating the order

Example:

"CUBBOCNCCUBBOCUBBO001"

location_name

string

Pickup point name

Example:

"Punto Cubbo Centro"

distance_km

number | null

Distance from the destination zip code in kilometers

Example:

0.8

pickup_address

string

Pickup point address

Example:

"Calle Centro 300, CDMX, 06000"

cnc_pricing_basis

enum<string>

Which input priced the pickup option

Available options:

cart_value,

item_count

Example:

"cart_value"

Authentication

Orders

Click and collect

Inventory

Lots

Shipping labels

Replenishments

Reports

Returns

Shipping methods

Stores

Webhooks

Quote shipping options for a destination and package

Authorizations

Query Parameters

Response